本文介绍使用现代 java.time api 替代过时的 date/calendar 类，精准判断两个日期是否为同一星期几（如“今天与计划日是否都是周一”），并规避因时区、dst 或时间截断引发的 7 天 vs 8 天偏差问题。
本文介绍使用现代 java.time api 替代过时的 date/calendar 类，精准判断两个日期是否为同一星期几（如“今天与计划日是否都是周一”），并规避因时区、dst 或时间截断引发的 7 天 vs 8 天偏差问题。
在 Java 中比较日期是否“相隔整周”或“同为某一天（如都是周一）”，若仍沿用 Date + Calendar + SimpleDateFormat 的旧式组合，极易因隐式时区转换、毫秒级精度截断、夏令时（DST）跳变等问题导致逻辑错误——正如提问中所示：本应相差 7 天的两个周一，却计算出 deltaDays = 8。
根本原因在于：
- Date 是带时间戳的毫秒值，本质表示瞬时时刻（Instant），而 SimpleDateFormat.format().parse() 强制截断为“yyyy-MM-dd”，但未清除原始 Date 中的时分秒及时区上下文；
- Calendar.add(Calendar.DAY_OF_WEEK, 7) 实际是按“日历日”加法，受当前 Calendar 的时区、DST 规则影响；当跨越 DST 调整边界（如 CET → CEST）时，1 天可能对应 23 或 25 小时，导致 getTime() 差值非严格 7×24×3600000 毫秒；
- 使用 TimeUnit.DAYS.convert(...) 对毫秒差取整，会因微小偏差（如 6 天 23 小时 59 分）向下取整为 6，或向上进位为 8，失去语义准确性。
✅ 正确解法：使用 java.time 包中的 LocalDate —— 它专为“仅日期”场景设计，无时间、无时区、无歧义。
✅ 推荐实践：基于 LocalDate 的清晰逻辑
import java.time.LocalDate;
import java.time.DayOfWeek;
import java.time.ZoneId;
// 1. 获取今日日期（基于系统默认时区，语义明确）
LocalDate today = LocalDate.now(ZoneId.systemDefault());
// 2. 计算下周同一天（例如：今天是周一 → 下周一）
LocalDate nextWeekSameDay = today.plusWeeks(1);
// 3. 获取计划日期（假设 actualStep.getPlannedDate() 返回 java.util.Date）
// 安全转换：先转 Instant，再按同一时区转为 LocalDate
LocalDate plannedDate = actualStep.getPlannedDate()
.toInstant()
.atZone(ZoneId.systemDefault())
.toLocalDate();
// 4. 判断是否为同一星期几（如均为 Monday）
boolean isSameDayOfWeek = today.getDayOfWeek().equals(plannedDate.getDayOfWeek());
// 5. 判断是否恰好相隔整周（即 plannedDate == nextWeekSameDay）
boolean isExactlyNextWeek = plannedDate.equals(nextWeekSameDay);⚠️ 关键注意事项
- 永远不要对 Date 做 format().parse() 截断：这会丢失原始时区信息，且在 DST 边界产生不可预测偏移；
- 避免 Calendar.DAY_OF_WEEK 加减：该字段用于获取星期几序号（1=Sunday），而非日期加法单位；应使用 Calendar.DATE 或直接切换到 LocalDate.plusDays()/plusWeeks()；
- 时区必须显式指定：LocalDate.now() 默认使用 ZoneId.systemDefault()，但在服务器部署时建议显式传入业务所需时区（如 ZoneId.of("Asia/Shanghai")），避免环境差异；
-
单元测试请固定时区：
// 测试中避免依赖系统时区 ZoneId testZone = ZoneId.of("UTC"); LocalDate today = LocalDate.now(testZone);
✅ 总结
日期比较的本质是语义对齐：若业务关心“是否同为周一”，就用 LocalDate.getDayOfWeek()；若关心“是否正好 7 天后”，就用 LocalDate.plusWeeks(1) 直接比对。抛弃 Date/Calendar 的历史包袱，拥抱 java.time 的不可变性、时区透明性与领域语义清晰性——这是写出健壮日期逻辑的唯一可靠路径。
立即学习“Java免费学习笔记（深入）”；
