Java常用时间处理类库与LocalDate

苏承栈

2026-09-11 • 👁 0人浏览过

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

到 SQL

DATE

类型 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

打交道。转换必须经过时区上下文，不能直接“强转”： Eclipse导入Android或其他的JAVA项目的正确方法 WORD版本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法；希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看下载立即学习 “ Java免费学习笔记（深入） ”；

LocalDate

→

java.util.Date

：先转

atStartOfDay(ZoneId.systemDefault())

得

ZonedDateTime

，再转

Instant

，最后到

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()

之类，可能引发数据错位。

相关文章