LocalDate仅含年月日,LocalDateTime含年月日及时分秒,二者均无时区、不可变、线程安全;用途不同:生日等纯日期用LocalDate,订单时间等需精确到秒用LocalDateTime。

LocalDate 和 LocalDateTime 的核心区别在哪
LocalDate 只表示年月日,不带时分秒和时区;LocalDateTime 是年月日 + 时分秒,依然不含时区信息。两者都不可变、线程安全,但用途截然不同:处理生日、合同生效日这类纯日期场景用 LocalDate;记录订单创建时间、日志打点等需要精确到秒的场景必须用 LocalDateTime。
常见错误是把数据库里带时间的 TIMESTAMP 字段映射成 LocalDate,结果小时分钟全丢,读出来的日期可能错一天(比如存的是 2024-05-01 23:59:59,转成 LocalDate 就变成 2024-05-01,再转回带时间类型可能默认变成当天零点)。
怎么从字符串正确解析这两种类型
不能直接用 parse() 方法硬解任意格式字符串——它只认 ISO 标准格式(LocalDate.parse("2024-05-01")、LocalDateTime.parse("2024-05-01T14:30:45"))。遇到中文格式如 "2024年05月01日" 或带空格的 "2024-05-01 14:30:45",必须显式传入 DateTimeFormatter:
LocalDate date = LocalDate.parse("2024年05月01日", DateTimeFormatter.ofPattern("yyyy年MM月dd日"));
LocalDateTime dt = LocalDateTime.parse("2024-05-01 14:30:45", DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
注意:DateTimeFormatter 不是线程安全的,别在类字段里复用未加锁的静态 formatter 实例;推荐用 static final 声明,或改用 DateTimeFormatter.ofPattern(...) 每次新建(JDK8+ 对常用 pattern 有缓存,开销不大)。
立即学习“Java免费学习笔记(深入)”;
和数据库交互时该选哪个类型
JDBC 4.2+ 规范支持直接绑定 LocalDate 和 LocalDateTime 到 PreparedStatement:
- 对应 SQL
DATE类型 → 用LocalDate - 对应 SQL
TIMESTAMP(无时区)→ 用LocalDateTime - 对应 SQL
TIMESTAMP WITH TIME ZONE→ 必须用ZonedDateTime或OffsetDateTime,LocalDateTime会静默丢失时区偏移
MyBatis、JPA 等框架底层依赖 JDBC 驱动实现。PostgreSQL 驱动能正确处理 LocalDateTime,但 MySQL 5.x 驱动对 LocalDateTime 支持不稳定,建议升级到 mysql-connector-java 8.0+ 并确认连接参数含 useLegacyDatetimeCode=false。
计算日期差容易踩的坑
Period.between() 返回的是“年月日”粒度的差值,适合算年龄、合同期限;Duration.between() 返回的是纳秒级时长,适合算耗时、超时阈值:
LocalDate start = LocalDate.of(2023, 1, 15); LocalDate end = LocalDate.of(2024, 3, 20); Period period = Period.between(start, end); // P1Y2M5D LocalDateTime now = LocalDateTime.now(); LocalDateTime later = now.plusHours(2).plusMinutes(30); Duration duration = Duration.between(now, later); // PT2H30M
别用 Period 去减两个 LocalDateTime——它会忽略时分秒,只比对年月日部分;也别用 Duration 算跨月天数,因为每月天数不固定,结果不符合业务直觉(比如 1 月 31 日到 2 月 28 日,Duration 算出来是 2592000 秒,但人眼认为是 28 天)。
真正难的是跨时区、夏令时、闰秒这些场景——LocalDate 和 LocalDateTime 都不处理,得换 ZonedDateTime 或 Instant。别指望它们能自动对齐不同时区的“同一天”。










