Java 日期时间——《跟老吕学Java》

Ja va 的日期时间处理，可以说是每个开发者迟早都要面对的话题。从早期的 ja va.util.Date 和 ja va.util.Calendar，到 Ja va 8 引入的 ja va.time 包，这一路走来，API 的设计思路和易用性都有了质的飞跃。下面就来系统梳理一下，尤其重点聊聊 ja va.time 这套“新式武器”。

Ja va日期时间

在很长一段时间里，ja va.util.Date 和 ja va.util.Calendar 是 Ja va 处理日期时间的“主力军”。但用过的人都知道，这两个类用起来有多别扭——月份从0开始、可变性带来的线程安全问题、时区处理一团糟……好在 Ja va 8 终于拿出了 ja va.time 包，彻底解决了这些历史遗留问题。

1. ja va.util.Date 和 ja va.util.Calendar

早期版本的 Date 和 Calendar 设计上确实有不少槽点：API 不够直观，时区处理不够灵活，而且这两个类是可变的，在多线程环境下稍不注意就会出问题。正因如此，Ja va 8 才下决心推出一套全新的日期时间 API。

2. ja va.time 包

ja va.time 包提供了丰富的类和方法，覆盖了日期、时间、时间间隔、时区等几乎所有的场景。几个最常用的类如下：

• LocalDate：只包含日期，不包含时间，适合处理生日、纪念日这类场景。
• LocalTime：只包含时间（时、分、秒、纳秒），没有日期信息。
• LocalDateTime：日期+时间，最常用的组合。
• ZonedDateTime：带时区的完整日期时间。
• Instant：时间戳，通常与 UTC 时区挂钩。
• Duration：时间间隔，以秒和纳秒为单位。
• Period：日期间隔，比如“2年3个月5天”。

3. 使用示例

光说不练假把式，直接看代码。

获取系统当前日期和时间

LocalDateTime now = LocalDateTime.now();
System.out.println(now);

创建指定日期和时间

LocalDateTime dateTime = LocalDateTime.of(2023, 3, 25, 14, 30, 45);
System.out.println(dateTime);

日期时间的加减

LocalDateTime later = dateTime.plusDays(1).plusHours(2);
System.out.println(later);
LocalDateTime earlier = dateTime.minusMonths(2);
System.out.println(earlier);

格式化日期时间

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String formattedDateTime = dateTime.format(formatter);
System.out.println(formattedDateTime);

解析字符串为日期时间

LocalDateTime parsedDateTime = LocalDateTime.parse("2023-03-25 14:30:45", formatter);
System.out.println(parsedDateTime);

比较日期大小

想比较两个 LocalDateTime 的大小，直接用 isBefore、isAfter 和 isEqual 方法，清晰又直观。

LocalDateTime earlierDate = LocalDateTime.of(2023, 1, 1, 0, 0);
LocalDateTime laterDate = LocalDateTime.of(2023, 12, 31, 23, 59);
if (earlierDate.isBefore(laterDate)) {
    System.out.println("earlierDate is before laterDate");
}
if (laterDate.isAfter(earlierDate)) {
    System.out.println("laterDate is after earlierDate");
}
if (earlierDate.isEqual(laterDate)) {
    System.out.println("Both dates are equal");
}

日期格式转换

有时候需要把 LocalDateTime 转成带时区的 ZonedDateTime，或者转成 Instant。下面这个例子展示了如何将 LocalDateTime 转为 ZonedDateTime：

ZoneId zoneId = ZoneId.systemDefault();
ZonedDateTime zonedDateTime = dateTime.atZone(zoneId);
System.out.println(zonedDateTime);

时间戳转日期

时间戳（从1970-01-01 00:00:00 UTC 开始的毫秒数）和日期时间之间的转换也是家常便饭。借助 Instant 类可以轻松搞定：

long timestamp = System.currentTimeMillis(); // 获取当前时间戳（毫秒）
Instant instant = Instant.ofEpochMilli(timestamp);
ZonedDateTime zonedDateTime = instant.atZone(ZoneId.systemDefault());
LocalDateTime dateTimeFromTimestamp = zonedDateTime.toLocalDateTime();
System.out.println(dateTimeFromTimestamp);

需要注意，从时间戳转到 LocalDateTime 时，时区设置会影响最终结果，千万别忽略这一点。

4. 时区处理

ja va.time 包中时区用 ZoneId 表示，带时区的日期时间则用 ZonedDateTime。比如你想表示上海时间：

ZoneId shanghaiZone = ZoneId.of("Asia/Shanghai");
ZonedDateTime shanghaiDateTime = dateTime.atZone(shanghaiZone);
System.out.println(shanghaiDateTime);

5. 转换为其他日期时间类

各个类之间的转换非常顺畅。比如把 LocalDateTime 转成 Instant：

Instant instant = dateTime.atZone(ZoneId.systemDefault()).toInstant();
System.out.println(instant);

反过来，把 Instant 转回 LocalDateTime：

LocalDateTime backToDateTime = instant.atZone(ZoneId.systemDefault()).toLocalDateTime();
System.out.println(backToDateTime);

6. 日期时间的比较

ja va.time 中的日期时间类都实现了 Comparable 接口，所以可以直接用 ==、<、> 等运算符——不过要小心，直接比纳秒差异可能会得到意想不到的结果。更稳妥的做法是用 isEqual、isBefore、isAfter 方法。

LocalDateTime dateTime1 = LocalDateTime.of(2023, 3, 25, 14, 30, 45);
LocalDateTime dateTime2 = LocalDateTime.of(2023, 3, 25, 14, 30, 46);
if (dateTime1.isBefore(dateTime2)) {
    System.out.println("dateTime1 is before dateTime2");
}

7. 线程安全性

这可能是新 API 最让人省心的一点：ja va.time 包中的大多数类都是不可变的（immutable）。一旦创建，值就不能再被修改，因此在多线程环境里可以放心共享，完全不需要加锁或同步措施。

8. 总结

从 ja va.util.Date 和 ja va.util.Calendar 到 ja va.time 包，Ja va 的日期时间 API 走过了一条不断进化的路。如今这套 API 不仅功能强大，而且设计直观、易于使用，还天然线程安全。如果你还在用 Ja va 8 或更高版本，请毫不犹豫地把 ja va.time 当作首选方案。无论是获取当前时间、创建指定日期、进行加减比较，还是处理时区、格式化解析，它都能给你一个干净利落的答案。