Java日期比较异常：间隔一周却得到不同天数差值求助

问题背景 #

需求是校验某日期是否为今日的下一周同一天，但两种场景下计算的天数差值分别为7和8，具体如下：

场景1：生产代码 #

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd", Locale.getDefault());

Calendar todayCalendar = Calendar.getInstance();
Date today = sdf.parse(sdf.format(todayCalendar.getTime()));

Step step = actualStep.getStep();
Date plannedDate = sdf.parse(sdf.format(actualStep.getPlannedDate()));

long diffInMillies = Math.abs(today.getTime() - plannedDate.getTime());
long deltaDays = TimeUnit.DAYS.convert(diffInMillies, TimeUnit.MILLISECONDS) +1L;

• 实际日期：Mon Mar 27 00:00:00 CEST 2023 和 Mon Mar 20 00:00:00 CET 2023
• 计算结果：deltaDays = 7

场景2：单元测试代码 #

Calendar todayCalendar = Calendar.getInstance();
Date today = todayCalendar.getTime();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
Integer day = 7;
todayCalendar.add(Calendar.DAY_OF_WEEK, +day);
Date expectedReminderDay = sdf.parse(sdf.format(todayCalendar.getTime()));

• 实际日期：Mon Mar 27 00:00:00 CEST 2023 和 Mon Apr 03 00:00:00 CEST 2023
• 计算结果：deltaDays = 8

核心原因分析 #

1. 夏令时切换导致的时间差偏差 #

场景1中的两个日期跨了中欧夏令时（CEST）切换节点：

• 3月20日使用中欧标准时间（CET，UTC+1），3月27日已切换为夏令时（CEST，UTC+2），切换时间是3月26日凌晨2点（直接跳转为3点，少了1小时）。
• 从Mar 20 00:00:00 CET到Mar 27 00:00:00 CEST的实际毫秒差为6天23小时（而非7天整）。

2. 天数计算逻辑的缺陷 #

你使用的deltaDays计算方式存在取整偏差：

long deltaDays = TimeUnit.DAYS.convert(diffInMillies, TimeUnit.MILLISECONDS) +1L;

• TimeUnit.DAYS.convert是向下取整计算完整天数：6天23小时会被转换为6，加1后得到7。
• 场景2中两个日期都处于夏令时区间，时间差是整整7天，convert得到7，加1后得到8。

3. Calendar.add(Calendar.DAY_OF_WEEK, +7)的实际效果 #

Calendar.DAY_OF_WEEK代表“星期几”字段，添加7等价于将日期调整到下一周的同一天，但此时两个日期都在夏令时区间内，时间差是完整的7天，因此触发了上述计算逻辑的差异。

建议修正方向 #

• 弃用Calendar和SimpleDateFormat这类过时API，改用Java 8+的java.time包（如LocalDate、ZonedDateTime），它对时区和夏令时的处理更精准。
• 直接使用日期类内置方法判断，比如LocalDate的plusWeeks(1).equals(targetDate)，无需手动计算毫秒差。

内容的提问来源于stack exchange，提问作者Cucumberbatch