将 java.util.Date 转换为 java.time 的 Instant、OffsetDateTime 或 ZonedDateTime

随着我们向现代 java.time 框架迁移，了解如何将遗留 java.util.Date 对象转换为适当的 java.time 类型至关重要。以下是等效项的概述：

java.util.Date 到 Instant

两者都代表 UTC 中的时刻，因此转换很简单：

Instant instant = myUtilDate.toInstant();

java.util.Date myUtilDate = java.util.Date.from(instant);

java.util.Date 到 java.time 的 OffsetDateTime 或 ZonedDateTime

因为这些类型包含时区信息，从遗留日期中提取区域是必要的：

// If the legacy date is a GregorianCalendar (which can hold time zone info)
if (myUtilCalendar instanceof GregorianCalendar) {
    GregorianCalendar gregCal = (GregorianCalendar) myUtilCalendar;
    ZonedDateTime zdt = gregCal.toZonedDateTime(); // ZonedDateTime with time zone

    java.util.Calendar myUtilCalendar = java.util.GregorianCalendar.from(zdt);
}

其他转换映射

重要注意事项

• 从 java.util.Date 转换为 java.time 类型可能会导致精度损失，如下所示遗留类不支持纳秒分辨率。
• 转换为 OffsetDateTime 或 ZonedDateTime 时，必须保留时区信息以确保正确解释。
• 强烈建议使用 java.time 类型在新代码中提高了精度和一致性。