深入理解 Java 8 的 LocalDateTime

在 Java 8 之前，日期和时间的处理一直是开发者的一个痛点。Java 的 Date 类虽然提供了基本的日期时间功能，但它存在诸多不足，比如可读性差、线程不安全等。幸运的是，Java 8 引入了新的日期时间 API，极大地简化了日期时间的处理。本文将重点介绍 LocalDateTime 类及其相关特性。

LocalDateTime 简介

LocalDateTime 是 Java 8 中 java.time 包的一部分，用于表示不带时区的日期和时间，即年、月、日、小时、分钟和秒。它与 LocalDate 和 LocalTime 类似，但结合了日期和时间的信息。

创建 LocalDateTime 对象

创建 LocalDateTime 对象非常简单，可以直接使用 now() 方法获取当前的日期和时间，或者使用 of() 方法指定具体的年、月、日、时、分、秒来创建。

LocalDateTime now = LocalDateTime.now();
LocalDateTime specific = LocalDateTime.of(2024, Month.AUGUST, 16, 15, 30, 0);

获取日期和时间部分

LocalDateTime 提供了多种方法来获取其组成部分，例如：

int year = now.getYear();
Month month = now.getMonth();
int day = now.getDayOfMonth();
int hour = now.getHour();
int minute = now.getMinute();
int second = now.getSecond();

修改 LocalDateTime

由于 LocalDateTime 是不可变的，任何修改操作都会返回一个新的实例。例如，增加一年或减少一个月：

LocalDateTime nextYear = now.plusYears(1);
LocalDateTime lastMonth = now.minusMonths(1);

使用 TemporalAdjuster

对于更复杂的日期调整，如调整到下个周日或本月的最后一天，可以使用 TemporalAdjuster 接口。Java 8 提供了 TemporalAdjusters 类，其中包含了许多预定义的调整器：

LocalDateTime nextSunday = now.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY));
LocalDateTime endOfMonth = now.with(TemporalAdjusters.lastDayOfMonth());

格式化和解析时间

使用 DateTimeFormatter 类可以轻松地格式化和解析日期时间字符串。它比旧的 SimpleDateFormat 更线程安全：

String formatted = now.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
LocalDateTime parsed = LocalDateTime.parse("2024-08-16 15:30:00", DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));

LocalDateTime 与 Date 的转换

在某些情况下，我们可能需要在 LocalDateTime 和 Date 之间进行转换。这可以通过将 LocalDateTime 转换为 Instant，然后再转换为 Date 来实现：

LocalDatetoDate(date) {
    return (date == null) ? null : Date.from(date.atStartOfDay(ZoneId.systemDefault()).toInstant());
}

LocalDateTimefromLocalDate(localDate) {
    return (localDate == null) ? null : localDate.atStartOfDay().toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
}

LocalDateTime 在 SpringBoot 中的应用

在 SpringBoot 应用中，LocalDateTime 可以以时间戳或指定格式的字符串形式返回给前端。这可以通过添加适当的注解来实现：

@JsonSerialize(using = LocalDateTimeConverter.class)
protected LocalDateTime gmtModified;

或者使用 @JsonFormat 注解来指定日期时间的格式：

@JsonFormat(shape=JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss")
protected LocalDateTime gmtModified;

结语

LocalDateTime 是 Java 8 日期时间 API 的核心部分，它提供了强大的功能来简化日期时间的处理。通过本文的介绍，希望您能够更深入地理解 LocalDateTime 的使用，并有效地应用到您的项目中。