如何正确使用java.time类？MongoDB日期存储最佳实践

1. LocalDate是否会受时区偏移影响？ #

不会。LocalDate仅包含年-月-日信息，没有时间和时区属性，MongoDB存储时会直接保留原日期值，不会进行任何时区转换。比如你存入2023-10-07，数据库里就会精确保存这个日期，不会出现偏移。

你遇到的LocalDateTime偏移问题，本质是因为LocalDateTime不带时区信息，MongoDB Java驱动默认会将其视为UTC时区的时间转换为BSON Date（BSON Date是基于UTC的时间戳）。如果你的LocalDateTime实际是本地时区（比如UTC+2）的时间，驱动会自动转成UTC时间存储，导致读取时出现时差。

2. 实体/文档类存储日期/日期时间的最佳实践 #

根据业务场景选择对应类型：

• 仅需日期（年月日）：用LocalDate，无歧义，存储和读取都不会有问题。
• 需记录精确时刻（跨时区场景）：优先用Instant，它是UTC时间线上的瞬时点，无时区歧义，MongoDB驱动会直接将其映射为BSON Date，存储和读取完全一致。
• 需保留时区信息：用ZonedDateTime，但要注意：BSON Date本身不存储时区，所以需要额外加一个字段（比如zoneId）来保存时区信息，否则读取时只能得到UTC时间戳，丢失时区上下文。
• 无时区的日期时间（比如固定日程）：用LocalDateTime，但必须在驱动层面明确转换规则，比如配置驱动将LocalDateTime按指定时区（而非默认UTC）转换为BSON Date，避免偏移。

另外，彻底抛弃java.util.Date这类遗留类，java.time包的API更安全、清晰，线程安全且功能完善。

3. 是否应使用ZonedDateTime替代LocalDateTime？ #

分场景判断：

• 如果你的业务需要明确的时区上下文（比如记录用户所在时区的操作时间，或跨时区业务需要追溯原始时区），建议用ZonedDateTime，同时配合单独的时区字段存储ZoneId，避免丢失时区信息。
• 如果只是记录精确时刻，不需要保留时区，用Instant比ZonedDateTime更简洁，因为Instant本身就是UTC的，无歧义。
• 如果是无时区依赖的日期时间（比如“每天18点推送消息”这种不绑定具体时区的规则），LocalDateTime更合适，只要配置好驱动的时区转换策略即可，不需要替换为ZonedDateTime。

内容的提问来源于stack exchange，提问作者Paul Marcelin Bejan