Java处理时间-java.time

在 Java 中，处理日期和时间的类经历了重大演进。根据你使用的 Java 版本不同，推荐使用不同的 API。以下是全面、清晰、现代的 Java 时间处理类总结（截至 Java 21）：

✅ 推荐：Java 8+ 使用java.time包（JSR-310）—— 现代、线程安全、易用

这是目前最推荐的方式，设计优秀，避免了旧 API 的诸多坑。

核心类概览

📌 常用示例（Java 8+）

importjava.time.*;importjava.time.format.DateTimeFormatter;publicclassModernTimeExample{publicstaticvoidmain(String[]args){// 1. 获取当前时间（系统默认时区）LocalDateTimenow=LocalDateTime.now();LocalDatetoday=LocalDate.now();ZonedDateTimezonedNow=ZonedDateTime.now();// 带时区// 2. 创建指定时间LocalDateTimedt=LocalDateTime.of(2026,2,9,17,30,45);LocalDatedate=LocalDate.of(2026,Month.FEBRUARY,9);// 3. 格式化输出DateTimeFormatterformatter=DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");System.out.println(now.format(formatter));// 2026-02-09 17:30:45// 4. 解析字符串LocalDateTimeparsed=LocalDateTime.parse("2026-02-09 17:30:45",formatter);// 5. 加减操作（不可变，返回新对象）LocalDateTimetomorrow=now.plusDays(1);LocalDateTimeoneHourAgo=now.minusHours(1);// 6. 转为时间戳（用于数据库或网络传输）Instantinstant=now.atZone(ZoneId.systemDefault()).toInstant();longepochMilli=instant.toEpochMilli();// 毫秒时间戳// 7. 从时间戳创建LocalDateTimefromTs=LocalDateTime.ofInstant(Instant.ofEpochMilli(epochMilli),ZoneId.systemDefault());}}

✅ 优点：不可变、线程安全、API 清晰、无夏令时陷阱（合理处理）

⚠️ 旧版 API（Java 8 之前）——不推荐新项目使用

这些类存在设计缺陷（非线程安全、月份从 0 开始、可变等），但你可能在老代码中见到。

❌ 旧 API 示例（仅作对比）

// 危险！SimpleDateFormat 非线程安全SimpleDateFormatsdf=newSimpleDateFormat("yyyy-MM-dd HH:mm:ss");Datedate=sdf.parse("2026-02-09 17:30:45");// 注意：月份不用减1？其实这里字符串解析没问题，但构造 Date 时 Calendar.MONTH 从0开始！// Calendar 月份从0开始（反人类）Calendarcal=Calendar.getInstance();cal.set(2026,Calendar.FEBRUARY,9);// 正确（因为 Calendar.FEBRUARY = 1）// cal.set(2026, 1, 9); // 也是2月，但容易混淆

🔁 新旧 API 互转（兼容老系统）

// Date → Instant → LocalDateTimeDateoldDate=newDate();Instantinstant=oldDate.toInstant();LocalDateTimeldt=LocalDateTime.ofInstant(instant,ZoneId.systemDefault());// LocalDateTime → DateLocalDateTimeldt=LocalDateTime.now();DatenewDate=Date.from(ldt.atZone(ZoneId.systemDefault()).toInstant());

📌 最佳实践建议

1. 新项目一律使用java.time（JSR-310）
2. 永远不要在多线程环境中共享SimpleDateFormat
3. 存储时间戳到数据库时，优先用Instant（UTC）或long毫秒值
4. 显示给用户时，再根据其时区格式化（如ZonedDateTime）
5. 避免使用System.currentTimeMillis()做业务逻辑，改用Instant.now()

🧩 补充：第三方库（通常不需要）

• Joda-Time：java.time的前身，Java 8 后官方已吸收其优点，无需再引入
• ThreeTenBP：Android 或 Java 6/7 项目可使用（Backport of JSR-310）

总结

💡记住：Java 8 的java.time是处理时间的终极答案，简洁、安全、强大。