Java新日期API详解：LocalDate与LocalDateTime使用教程

本文深入解析了Java 8引入的新日期API中LocalDate与LocalDateTime的核心差异与实战要点：前者仅表示无时区的年月日，适用于生日、合同日期等纯日期场景；后者则精确到秒，适合订单时间、日志记录等需时间精度的业务，二者均不可变且线程安全，但绝不能混用——尤其警惕将带时间的数据库TIMESTAMP错误映射为LocalDate导致的时间丢失和日期偏移；文章还详解了非ISO格式字符串的安全解析技巧、JDBC交互中的类型匹配原则（DATE→LocalDate，TIMESTAMP→LocalDateTime）、日期差计算的正确姿势（Period用于年月日逻辑差，Duration用于精确时长），并明确指出二者在跨时区、夏令时等复杂场景下的局限性，助你避开高频坑点，写出更健壮、可维护的时间处理代码。

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 有缓存，开销不大）。

和数据库交互时该选哪个类型

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。别指望它们能自动对齐不同时区的“同一天”。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~