LocalDate 是 Java 8 引入的不可变日期类，仅表示“年-月-日”，替代易错、线程不安全的 Date 和繁琐的 Calendar；构造直观（月份 1–12）、线程安全、无时区歧义、支持 JDBC 4.2+ 直接映射。
LocalDate 是什么，为什么不用 Date 或 Calendar
LocalDate 是 Java 8 引入的 java.time 包中的不可变日期类，只表示“年-月-日”，不含时分秒和时区。它替代了过去容易出错、线程不安全的 Date 和操作繁琐的 Calendar。
常见错误现象：用 new Date(2023, 1, 1)（月份从 0 开始）或 calendar.set(2023, 12, 1)（月份传 12 实际是下一年 1 月）导致日期偏移；SimpleDateFormat 非线程安全，在多线程中解析出错。
-
LocalDate构造直观：LocalDate.of(2023, 1, 1)，月份 1–12，无歧义 - 所有方法返回新对象，天然线程安全
- 不隐含时区或时间信息，避免“本地时间 vs UTC”混淆
- 与数据库交互时，JDBC 4.2+ 支持直接映射
LocalDate到 SQLDATE类型
LocalDate 常用操作与易错点
日常开发中，LocalDate 主要用于计算天数差、加减月份、校验范围、格式化输出等。但几个参数和行为容易踩坑：
-
plusDays()/minusMonths()等方法返回新实例，原对象不变 —— 忘记赋值是高频 Bug -
withYear(2025)会保留原有月日，但如果原日期是 2024-02-29，调用后抛DateTimeException（2025 年没有 2 月 29 日） -
isBefore()/isAfter()比较的是日期本身，不涉及时间或时区；但若混用LocalDateTime或ZonedDateTime，需先统一类型再比较 - 解析字符串时，
LocalDate.parse("2023/01/01", DateTimeFormatter.ofPattern("yyyy/MM/dd"))必须显式传格式器，否则默认只认"2023-01-01"
LocalDate today = LocalDate.now(); LocalDate nextWeek = today.plusDays(7); // ✅ 正确 today.plusDays(7); // ❌ 丢弃结果，today 不变 LocalDate invalid = LocalDate.of(2024, 2, 29).withYear(2025); // 抛异常
LocalDate 与旧 API 的互操作
老项目难免要和 Date、Calendar 或 java.sql.Date 打交道。转换必须经过时区上下文，不能直接“强转”：
wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support
下载
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
立即学习“Java免费学习笔记（深入）”；
-
LocalDate→java.util.Date：先转atStartOfDay(ZoneId.systemDefault())得ZonedDateTime，再转Instant，最后到Date -
Date→LocalDate：先用date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate()—— 注意时区影响结果（例如在东八区，new Date(0)转成LocalDate是 1970-01-01，但在西五区可能是 1969-12-31） -
java.sql.Date可直接调用.toLocalDate()方法（JDBC 4.2+），比走java.util.Date更简洁安全
java.sql.Date sqlDate = java.sql.Date.valueOf("2023-05-20");
LocalDate localDate = sqlDate.toLocalDate(); // ✅ 推荐
Date utilDate = new Date();
LocalDate fromUtil = utilDate.toInstant()
.atZone(ZoneId.systemDefault())
.toLocalDate(); // ⚠️ 依赖系统默认时区
序列化与 JSON 处理注意事项
Spring Boot 默认用 Jackson 序列化 LocalDate，但行为取决于配置：
- 未配置时，默认输出为数组格式：
[2023,5,20]，前端解析麻烦且不直观 - 加
@JsonFormat(pattern = "yyyy-MM-dd")可控输出字符串，但需每个字段加注解，维护成本高 - 全局配置推荐在
application.yml中设：spring.jackson.date-format=yyyy-MM-dd和spring.jackson.serialization.write-dates-as-timestamps=false - MyBatis 等 ORM 框架通常能自动处理
LocalDate与数据库DATE字段映射，无需额外 TypeHandler（除非用老版本）
真正容易被忽略的是时区隐含假设：所有 LocalDate 序列化/反序列化都默认基于系统时区做“起点对齐”，一旦服务部署在不同时区机器上，且代码里又用了 LocalDateTime.now() 之类，可能引发数据错位。
