前言

“时间”是 Java 最劝退的 API 之一：

  • 旧版 Date 月份从 0 开始，SimpleDateFormat 非线程安全；

  • 国际化、夏令时、跨年周数……踩不完的坑。

直到 Java 8 发布 java.time（JSR-310），官方终于给出“能看又好用”的解决方案。 今天这篇，带你 从 0 到 1 掌握现代 Java 时间处理，并给出可直接落地的最佳实践。

一、为什么抛弃 Date/Calendar？

旧类

典型槽点

线程安全

java.util.Date

月份 0 起算、同时承载日期+时间、毫秒精度

否

Calendar

可变性 + 字段魔法数、周计算反直觉

否

SimpleDateFormat

parse/format 前要先加锁，高并发必炸

否

结论：只维护老代码时用，新工程请直接 java.time 。

二、java.time 五件套（先背下来）

LocalDate ➜ 2025-12-22 
LocalTime ➜ 14:30:45.123 
LocalDateTime ➜ 2025-12-22T14:30:45.123 
ZonedDateTime ➜ 2025-12-22T14:30:45+08:00[Asia/Shanghai] 
Instant ➜ 秒 / 毫秒级时间戳

都是不可变对象，每次“加减”都会返回新实例，天然线程安全 。

三、30 秒速查表（收藏备用）

需求

代码

今天

LocalDate today = LocalDate.now();

此刻

LocalDateTime now = LocalDateTime.now();

解析

LocalDate d = LocalDate.parse("2025-12-22");

自定义格式

LocalDateTime.parse("12/22/2025 14:30", DateTimeFormatter.ofPattern("MM/dd/yyyy HH:mm"))

格式化输出

String s = now.format(DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm"));

加 1 天

LocalDate tomorrow = today.plusDays(1);

减 1 月

LocalDate prev = today.minusMonths(1);

间隔天数

long days = ChronoUnit.DAYS.between(today, endDate);

间隔毫秒

long ms = Duration.between(start, end).toMillis();

时区转换

ZonedDateTime ny = shanghai.withZoneSameInstant(ZoneId.of("America/New_York"));

四、4 个实战场景（复制即用）

① 合同到期提醒

LocalDate sign = LocalDate.of(2025, 6, 1); 
LocalDate expire = sign.plusMonths(6).minusDays(1); // 2025-11-30 
long remainDays = ChronoUnit.DAYS.between(LocalDate.now(), expire); 
System.out.println("还有 " + remainDays + " 天到期");

② 解析前端参数（容错写法）

DateTimeFormatter FMT = DateTimeFormatter.ofPattern("yyyyMMddHHmmss"); 
LocalDateTime dt = LocalDateTime.parse("20251222153000", FMT);

③ 跨时区开会（上海 → 纽约）

ZonedDateTime sh = ZonedDateTime.of( LocalDateTime.of(2025, 12, 25, 9, 0), ZoneId.of("Asia/Shanghai")); 
ZonedDateTime ny = sh.withZoneSameInstant(ZoneId.of("America/New_York")); System.out.println("纽约时间：" + ny); // 2025-12-24T20:00-05:00[America/New_York]

④ 高并发计时（安全 + 无锁）

Instant start = Instant.now(); // ...业务... 
long cost = Duration.between(start, Instant.now()).toMillis();

五、新旧代码共存（维护老系统必备）

方向

示例

Date → LocalDateTime

LocalDateTime ldt = date.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();

LocalDateTime → Date

Date d = Date.from(ldt.atZone(ZoneId.systemDefault()).toInstant());

SimpleDateFormat 务必加锁或使用 ThreadLocal；Java 8+ 推荐直接 DateTimeFormatter 。

六、常见坑 & 最佳实践

  1. 不可变！ 加减后一定要接收返回值 date.plusDays(1); // ❌ 没意义 date = date.plusDays(1); // ✅

  2. LocalDateTime 不带时区，不能直接转时间戳 long epoch = ldt.atZone(ZoneId.systemDefault()).toEpochSecond();

  3. 格式字母区分大小写 yyyy-MM-dd HH:mm:ss 别写成 YYYY-MM-DD hh:mm:ss，否则跨年周会翻车 。

  4. 高并发场景拒绝 SimpleDateFormat，用 DateTimeFormatter 线程安全 。

  5. 前端 ↔ 后端日期字符串 SpringBoot 项目直接加注解，零配置： @DateTimeFormat(pattern = "yyyy-MM-dd") // 入参 @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8") // 出参 private LocalDate signDate;

七、一张思维导图（保存即可）

java.time 
├─ LocalDate / LocalTime / LocalDateTime 人类可读 
├─ ZonedDateTime 带时区 
├─ Instant 机器时间戳 
├─ Duration / Period 时间差 
└─ DateTimeFormatter 格式/解析

八、总结一句话

新项目请默认 java.time，老项目逐步迁移；记住 Local-日期时间、Zoned-时区、Instant-时间戳、Duration-间隔、DateTimeFormatter-格式 五件套，所有时间操作都能优雅解决！

# python # 开发语言 # java
Logo
AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

cover

掌握 Harness：让你的 AI Agent 从“纸上谈兵”到“真枪实弹”

avatar AI Agent技术社区
cover

TRAE和Qoder选择建议：办公AI Agent怎么选更适配？

avatar AI Agent技术社区

双击右ALT莫名其妙变成了语音转换！！

起因：使用IDEA快捷键 右Alt + Enter，只有Enter生效，但换成左Alt又没问题 🤔。难道是华为电脑管家带的什么辅助功能，关掉发现还有。自动更新，默认开启AI语音输入占用快捷键！一定是Win11更新搞的鬼，改注册表，重启发现好了，双击右Alt不会出现了，刚开始怀疑IDEA设置问题，发现不是。突然灵机一现，发现把钉钉关掉就好了，或者 改成其他快捷键就好了。正常使用了一会，又出现了？

avatar AI Agent技术社区