java.util.Calendar时区更新异常：日期未正确转换问题

该方法旨在接收UTC日期，转换为指定时区并返回DateTimeValue对象，但近期发现部分时区下存在bug。

原代码实现：

private static DateTimeValue toDateTimeValue(Date endDate, TimeZone timeZone) {     
    Calendar cal = Calendar.getInstance();
    cal.setTime(endDate);
    cal.setTimeZone(timeZone);
    cal.set(Calendar.HOUR_OF_DAY, 23); // move to the end of the day
    cal.set(Calendar.MINUTE, 59);
    cal.set(Calendar.SECOND, 59);
    int year = cal.get(Calendar.YEAR);
    int month = cal.get(Calendar.MONTH) + 1;
    int day = cal.get(Calendar.DAY_OF_MONTH);  //ends up being 3 but should be 4
    int hour = cal.get(Calendar.HOUR_OF_DAY);
    int minute = cal.get(Calendar.MINUTE);
    int second = cal.get(Calendar.SECOND);

    return new DateTimeValueImpl(year, month, day, hour, minute, second);
}

核心问题场景：

• endDate值：Mon Oct 03 21:00:00 UTC 2022
• 时区值：Europe/Helsinki (+3)

上述方法中获取的日期为3号，但实际UTC时间2022年10月3日21:00对应赫尔辛基时区的10月4日，日期应为4号。

我用以下代码测试可得到正确结果，但仅为字符串格式，无法直接转为DateTimeValue：

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
sdf.setTimeZone(TimeZone.getTimeZone("UTC"));
String utcDate = sdf.format(endDate); 
System.out.println(utcDate);   //2022-10-03 09:00:00

sdf.setTimeZone(timeZone);
String timeZoneDate = sdf.format(endDate);
System.out.println(timeZoneDate);   //2022-10-04 12:00:00

请问为何java.util.Calendar设置为赫尔辛基时区后，日期（日）未正确更新？

问题原因 #

你的代码逻辑顺序错误：先调用cal.setTime(endDate)，再调用cal.setTimeZone(timeZone)，这会导致时区转换不生效。

Calendar的setTime方法会用当前Calendar的时区（默认是系统时区）解析传入的Date对象，之后调用setTimeZone只是改变Calendar的显示时区，不会重新根据时间戳计算对应时区的日期时间。相当于把一个用默认时区解析出的时间，直接切换显示时区，而非将UTC时间转换为目标时区的时间。

修正后的代码 #

正确顺序是先设置时区，再设置时间：

private static DateTimeValue toDateTimeValue(Date endDate, TimeZone timeZone) {     
    Calendar cal = Calendar.getInstance(timeZone); // 直接创建指定时区的Calendar
    cal.setTime(endDate); // 此时用指定时区解析Date的时间戳
    cal.set(Calendar.HOUR_OF_DAY, 23);
    cal.set(Calendar.MINUTE, 59);
    cal.set(Calendar.SECOND, 59);
    int year = cal.get(Calendar.YEAR);
    int month = cal.get(Calendar.MONTH) + 1;
    int day = cal.get(Calendar.DAY_OF_MONTH);
    int hour = cal.get(Calendar.HOUR_OF_DAY);
    int minute = cal.get(Calendar.MINUTE);
    int second = cal.get(Calendar.SECOND);

    return new DateTimeValueImpl(year, month, day, hour, minute, second);
}

或者先创建默认Calendar，先设时区再赋值时间：

private static DateTimeValue toDateTimeValue(Date endDate, TimeZone timeZone) {     
    Calendar cal = Calendar.getInstance();
    cal.setTimeZone(timeZone); // 先设置时区
    cal.setTime(endDate); // 再用指定时区解析时间戳
    cal.set(Calendar.HOUR_OF_DAY, 23);
    cal.set(Calendar.MINUTE, 59);
    cal.set(Calendar.SECOND, 59);
    // ... 后续取值逻辑不变
}

更推荐的方案：使用Java 8+的java.time API #

java.util.Calendar和Date是旧API，存在诸多设计缺陷，推荐用Java 8引入的java.time包处理时区转换：

private static DateTimeValue toDateTimeValue(Date endDate, ZoneId zoneId) {
    // 将Date转换为UTC时间戳，再转为目标时区的日期时间
    ZonedDateTime zonedDateTime = endDate.toInstant().atZone(zoneId);
    // 设置为当天最后一秒
    zonedDateTime = zonedDateTime.with(LocalTime.MAX);
    // 提取字段
    int year = zonedDateTime.getYear();
    int month = zonedDateTime.getMonthValue();
    int day = zonedDateTime.getDayOfMonth();
    int hour = zonedDateTime.getHour();
    int minute = zonedDateTime.getMinute();
    int second = zonedDateTime.getSecond();

    return new DateTimeValueImpl(year, month, day, hour, minute, second);
}

调用时传入ZoneId.of("Europe/Helsinki")即可，该API逻辑清晰，完全规避旧API的时区陷阱。

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