一、Java 日期时间 API 的演进：从 “混乱” 到 “规范”
在 Java 8 之前，处理日期时间主要依赖
java.util.Date和java.util.Calendar，但这两个类存在诸多设计缺陷：- 线程不安全：
SimpleDateFormat（用于日期格式化）和Calendar的修改方法（如add）是非线程安全的，多线程环境下易出现数据错乱。 - API 设计混乱：
Date类的年份从 1900 开始（new Date(2023, 9, 1)实际表示 2023+1900=3923 年），月份从 0 开始（9 代表 10 月），极易引发混淆。 - 功能割裂：日期（年 / 月 / 日）和时间（时 / 分 / 秒）的处理分散在不同方法中，时区处理需要额外依赖
TimeZone，使用复杂。
为解决这些问题，Java 8（2014 年）引入了全新的日期时间 API——
java.time包，该方案借鉴了 Joda-Time 的设计思想，具有线程安全、API 清晰、功能完备等优势，成为目前推荐的日期时间处理方案。二、java.time 核心类详解
java.time包提供了多个针对不同场景的日期时间类，核心类如下：1. 本地日期时间：LocalDate、LocalTime、LocalDateTime
这三个类用于处理不含时区的日期时间，适用于不需要考虑时区的场景（如 “生日”“会议时间（本地）”）。
- LocalDate：仅包含 “年 - 月 - 日”，如
2023-10-01。 - LocalTime：仅包含 “时 - 分 - 秒 - 纳秒”，如
15:30:45.123。 - LocalDateTime：组合日期和时间，如
2023-10-01T15:30:45。
（1）对象创建
-
获取当前时间：通过
now()方法：LocalDate today = LocalDate.now(); // 2023-10-01（当前日期） LocalTime nowTime = LocalTime.now(); // 15:30:45.123456789（当前时间） LocalDateTime now = LocalDateTime.now(); // 2023-10-01T15:30:45.123456789 -
指定日期时间：通过
of()方法（参数顺序直观，年份直接传实际值，月份从 1 开始）：LocalDate birthday = LocalDate.of(2000, 5, 20); // 2000-05-20 LocalTime meetingTime = LocalTime.of(9, 30); // 09:30:00 LocalDateTime event = LocalDateTime.of(2023, 12, 31, 23, 59, 59); // 2023-12-31T23:59:59
（2）解析与格式化
-
解析字符串：通过
parse()方法将字符串转换为日期时间对象（默认支持 ISO 格式，如yyyy-MM-dd）：LocalDate date = LocalDate.parse("2023-10-01"); // 解析ISO日期 LocalTime time = LocalTime.parse("15:30:45"); // 解析ISO时间 LocalDateTime dt = LocalDateTime.parse("2023-10-01T15:30:45"); // 解析ISO日期时间
如需解析自定义格式（如MM/dd/yyyy），需配合DateTimeFormatter：DateTimeFormatter formatter = DateTimeFormatter.ofPattern("MM/dd/yyyy"); LocalDate date = LocalDate.parse("10/01/2023", formatter); // 2023-10-01 -
格式化输出：通过
format()方法将对象转换为指定格式的字符串：LocalDateTime now = LocalDateTime.now(); DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss"); String str = now.format(formatter); // 例如：2023年10月01日 15:30:45
注意：DateTimeFormatter是线程安全的，可全局复用，解决了SimpleDateFormat的线程安全问题。
（3）修改日期时间
java.time的类都是不可变对象（类似 String），修改操作会返回新对象，原对象不变：LocalDate date = LocalDate.of(2023, 10, 01);
LocalDate nextDay = date.plusDays(1); // 加1天 → 2023-10-02
LocalDate lastMonth = date.minusMonths(1); // 减1个月 → 2023-09-01
LocalDate firstDayOfMonth = date.withDayOfMonth(1); // 当月1日 → 2023-10-01
类似方法：
plusYears()/minusYears()（年）、plusMonths()/minusMonths()（月）等。2. 带时区的日期时间：ZonedDateTime
ZonedDateTime用于处理含时区的日期时间，适用于跨时区场景（如 “全球会议时间转换”“服务器日志（统一时区）”）。它包含三部分：本地日期时间（LocalDateTime）、时区（ZoneId）、偏移量（ZoneOffset，与 UTC 的时差）。（1）对象创建
-
获取当前时区时间：
// 系统默认时区（如Asia/Shanghai） ZonedDateTime shanghaiTime = ZonedDateTime.now(); // 指定时区（如纽约：America/New_York） ZonedDateTime newYorkTime = ZonedDateTime.now(ZoneId.of("America/New_York")); -
指定时区和日期时间：
ZonedDateTime zdt = ZonedDateTime.of(2023, 10, 01, 15, 30, 0, 0, // 年-月-日 时-分-秒-纳秒ZoneId.of("Asia/Shanghai") // 时区 ); // 2023-10-01T15:30+08:00[Asia/Shanghai]
（2）时区转换
通过
withZoneSameInstant()方法将时间转换到另一个时区（瞬间不变，时区变化）：ZonedDateTime shanghai = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"));
// 转换为纽约时间（同一瞬间，不同时区的表示）
ZonedDateTime newYork = shanghai.withZoneSameInstant(ZoneId.of("America/New_York"));
3. 时间戳：Instant
Instant表示UTC 时间线中的一个瞬间（从 1970-01-01T00:00:00Z 开始的秒数，类似 Unix 时间戳），适用于需要统一时间基准的场景（如日志时间、分布式系统时间同步）。-
创建与转换：
Instant now = Instant.now(); // 当前UTC时间戳（如2023-10-01T07:30:45.123Z） long epochSecond = now.getEpochSecond(); // 从1970年到现在的秒数 Instant instant = Instant.ofEpochSecond(1696126245); // 根据秒数创建 -
与
ZonedDateTime转换：Instant instant = Instant.now(); ZonedDateTime shanghai = instant.atZone(ZoneId.of("Asia/Shanghai")); // 转换为上海时区时间
4. 时间间隔：Period 与 Duration
-
Period：计算两个日期（LocalDate）之间的间隔（年 / 月 / 日）：
LocalDate start = LocalDate.of(2020, 1, 1); LocalDate end = LocalDate.of(2023, 10, 1); Period period = Period.between(start, end); System.out.println(period.getYears()); // 3（年差） System.out.println(period.getMonths()); // 9（月差） System.out.println(period.getDays()); // 0（日差） -
Duration：计算两个时间（LocalTime/LocalDateTime/Instant）之间的间隔（时 / 分 / 秒）：
LocalTime start = LocalTime.of(9, 0); LocalTime end = LocalTime.of(15, 30); Duration duration = Duration.between(start, end); System.out.println(duration.toHours()); // 6（小时） System.out.println(duration.toMinutes()); // 390（分钟）
三、新旧 API 对比与最佳实践
| 特性 | 旧 API（Date/Calendar） | 新 API（java.time） |
|---|---|---|
| 线程安全 | 非线程安全（如 SimpleDateFormat） | 线程安全（不可变对象） |
| API 设计 | 混乱（年份 / 月份偏移） | 直观（参数直接对应实际值） |
| 时区处理 | 复杂（依赖 TimeZone） | 简洁（ZonedDateTime 直接支持） |
| 功能完备性 | 弱（需手动实现间隔计算等） | 强（内置 Period/Duration 等） |
最佳实践：
- 新项目完全使用
java.time包，避免使用Date、Calendar和SimpleDateFormat。 - 如需与旧 API 交互（如遗留系统），可通过
toInstant()（旧→新）或from()（新→旧）方法转换：// Date → Instant（旧→新） Date oldDate = new Date(); Instant instant = oldDate.toInstant();// Instant → Date（新→旧） Date newDate = Date.from(instant);
- 处理跨时区场景时，优先使用
ZonedDateTime，避免手动计算时差。