Java8日期时间API教程详解

还在为 Java 中繁琐的日期时间处理而烦恼吗？本文将带你全面解析 Java 8 引入的全新日期时间 API，彻底告别 `java.util.Date` 和 `java.util.Calendar` 的痛点。深入理解 `LocalDate`、`LocalTime` 和 `LocalDateTime` 三大核心类的区别与应用，轻松掌握如何创建、格式化以及计算日期和时间。时区处理不再是难题，`ZonedDateTime` 和 `OffsetDateTime` 的使用技巧让你应对各种复杂场景。此外，本文还提供了与旧 API 的无缝转换方案，以及最佳实践和常见错误规避，助你编写更清晰、更易于维护且线程安全的 Java 代码。立即学习，提升你的 Java 日期时间处理技能！

Java 8 日期时间 API 提供了 LocalDate、LocalTime 和 LocalDateTime 三个核心类，分别用于表示仅日期、仅时间和日期时间组合。1. LocalDate 表示如“2023-10-27”的日期，不含时间与时区；2. LocalTime 表示如“10:30:00”的时间，不含日期与时区；3. LocalDateTime 表示如“2023-10-27T10:30:00”的日期和时间，仍不包含时区信息。这些类均不可变，保障了线程安全。创建可通过 now() 获取当前值或 of() 指定具体值，格式化使用 DateTimeFormatter，支持预定义与自定义模式。日期计算通过 plus 或 minus 方法实现，返回新实例，也可用 Period 和 Duration 表示时间段。时区处理由 ZonedDateTime（含完整时区规则）和 OffsetDateTime（含 UTC 偏移）负责。与旧 API 的转换通过 toInstant、atZone 等方法完成。最佳实践包括始终使用不可变类、选择合适类型、使用格式化工具、注意时区影响并避免使用旧类，同时谨记操作后需重新赋值以避免错误。

Java 8 引入的日期时间 API 彻底改变了我们在 Java 中处理日期和时间的方式。它解决了 java.util.Date 和 java.util.Calendar 类中存在的许多问题，提供了更清晰、更易于使用且线程安全的 API。本文将深入探讨 Java 8 日期时间 API 的各个方面，并提供清晰的示例，帮助你全面掌握它。

LocalDateTime、LocalDate 和 LocalTime 的区别是什么？

Java 8 日期时间 API 提供了三个核心类：LocalDateTime、LocalDate 和 LocalTime。它们之间的区别在于它们表示的时间信息的完整性。

• LocalDate: 仅表示日期，不包含时间和时区信息。例如：2023-10-27。
• LocalTime: 仅表示时间，不包含日期和时区信息。例如：10:30:00。
• LocalDateTime: 表示日期和时间，但不包含时区信息。例如：2023-10-27T10:30:00。

选择哪个类取决于你的具体需求。如果只需要日期，则使用 LocalDate。如果只需要时间，则使用 LocalTime。如果需要日期和时间，则使用 LocalDateTime。 重要的是，这些类都是不可变的，这意味着一旦创建，它们的值就不能被修改。每次操作都会返回一个新的实例。这避免了并发问题，因为多个线程可以安全地访问和操作这些对象。

如何创建和格式化日期和时间？

创建日期和时间对象非常简单。你可以使用 now() 方法获取当前日期和时间，或者使用 of() 方法创建指定日期和时间的对象。

// 获取当前日期
LocalDate today = LocalDate.now();
System.out.println("Today's date: " + today);

// 获取当前时间
LocalTime now = LocalTime.now();
System.out.println("Current time: " + now);

// 获取当前日期和时间
LocalDateTime nowDateTime = LocalDateTime.now();
System.out.println("Current date and time: " + nowDateTime);

// 创建指定日期
LocalDate specificDate = LocalDate.of(2024, 1, 1);
System.out.println("Specific date: " + specificDate);

// 创建指定时间
LocalTime specificTime = LocalTime.of(14, 30, 0);
System.out.println("Specific time: " + specificTime);

// 创建指定日期和时间
LocalDateTime specificDateTime = LocalDateTime.of(2024, 1, 1, 14, 30, 0);
System.out.println("Specific date and time: " + specificDateTime);

格式化日期和时间可以使用 DateTimeFormatter 类。DateTimeFormatter 提供了多种预定义的格式，也可以自定义格式。

// 使用预定义格式
DateTimeFormatter dateFormatter = DateTimeFormatter.ISO_DATE;
System.out.println("Formatted date (ISO_DATE): " + today.format(dateFormatter));

// 使用自定义格式
DateTimeFormatter customFormatter = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
System.out.println("Formatted date and time (custom): " + nowDateTime.format(customFormatter));

DateTimeFormatter 还有一个 withLocale() 方法，可以指定不同的 Locale，从而根据不同的地区习惯进行格式化。

如何进行日期和时间的计算？

Java 8 日期时间 API 提供了丰富的计算方法，可以方便地进行日期和时间的加减操作。这些方法都返回一个新的对象，而不是修改原始对象。

LocalDate tomorrow = today.plusDays(1);
System.out.println("Tomorrow: " + tomorrow);

LocalDate lastWeek = today.minusWeeks(1);
System.out.println("Last week: " + lastWeek);

LocalTime later = now.plusHours(2);
System.out.println("2 hours later: " + later);

LocalDateTime nextMonth = nowDateTime.plusMonths(1);
System.out.println("Next month: " + nextMonth);

除了加减操作，还可以使用 Period 和 Duration 类来表示时间段。

// 计算两个日期之间的天数
LocalDate date1 = LocalDate.of(2023, 1, 1);
LocalDate date2 = LocalDate.of(2023, 10, 27);
Period period = Period.between(date1, date2);
System.out.println("Days between date1 and date2: " + period.getDays());

// 计算两个时间之间的小时数
LocalTime time1 = LocalTime.of(10, 0, 0);
LocalTime time2 = LocalTime.of(12, 30, 0);
Duration duration = Duration.between(time1, time2);
System.out.println("Hours between time1 and time2: " + duration.toHours());

时区处理：ZonedDateTime 和 OffsetDateTime 的使用

Java 8 日期时间 API 提供了 ZonedDateTime 和 OffsetDateTime 类来处理时区。ZonedDateTime 包含了时区信息，而 OffsetDateTime 包含了与 UTC 的偏移量。

// 获取当前时区的日期和时间
ZonedDateTime zonedDateTime = ZonedDateTime.now();
System.out.println("Current date and time with time zone: " + zonedDateTime);

// 指定时区
ZoneId zoneId = ZoneId.of("America/Los_Angeles");
ZonedDateTime losAngelesTime = ZonedDateTime.now(zoneId);
System.out.println("Current date and time in Los Angeles: " + losAngelesTime);

// 获取当前日期和时间与 UTC 的偏移量
OffsetDateTime offsetDateTime = OffsetDateTime.now();
System.out.println("Current date and time with offset: " + offsetDateTime);

ZonedDateTime 更适合表示具有特定时区规则的日期和时间，例如会议时间。OffsetDateTime 更适合存储日期和时间，以及与 UTC 的偏移量，例如数据库中的时间戳。

与旧 API 的兼容性：Date 和 Calendar 的转换

虽然 Java 8 日期时间 API 提供了更好的替代方案，但在某些情况下，你可能需要与旧的 java.util.Date 和 java.util.Calendar 类进行交互。Java 8 提供了方便的方法来进行转换。

// Date 转换为 LocalDate
Date date = new Date();
LocalDate localDate = date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();
System.out.println("Date to LocalDate: " + localDate);

// LocalDate 转换为 Date
LocalDate localDate2 = LocalDate.now();
Date date2 = Date.from(localDate2.atStartOfDay(ZoneId.systemDefault()).toInstant());
System.out.println("LocalDate to Date: " + date2);

// Calendar 转换为 ZonedDateTime
Calendar calendar = Calendar.getInstance();
ZonedDateTime zonedDateTime2 = ZonedDateTime.ofInstant(calendar.toInstant(), calendar.getTimeZone().toZoneId());
System.out.println("Calendar to ZonedDateTime: " + zonedDateTime2);

// ZonedDateTime 转换为 Calendar
ZonedDateTime zonedDateTime3 = ZonedDateTime.now();
Calendar calendar2 = GregorianCalendar.from(zonedDateTime3);
System.out.println("ZonedDateTime to Calendar: " + calendar2);

这些转换方法允许你在新旧 API 之间平滑过渡。

最佳实践和常见错误

• 始终使用不可变类: LocalDate、LocalTime、LocalDateTime、ZonedDateTime 和 OffsetDateTime 都是不可变类。这意味着每次操作都会返回一个新的对象，而不是修改原始对象。这可以避免并发问题。
• 选择合适的类: 根据你的具体需求选择合适的类。如果只需要日期，则使用 LocalDate。如果只需要时间，则使用 LocalTime。如果需要日期和时间，则使用 LocalDateTime。如果需要处理时区，则使用 ZonedDateTime 或 OffsetDateTime。
• 使用 DateTimeFormatter 进行格式化: 使用 DateTimeFormatter 类进行日期和时间的格式化。DateTimeFormatter 提供了多种预定义的格式，也可以自定义格式。
• 注意时区: 在处理日期和时间时，一定要注意时区。使用 ZoneId 类来指定时区。
• 避免使用旧 API: 尽可能使用 Java 8 日期时间 API，而不是旧的 java.util.Date 和 java.util.Calendar 类。

一个常见的错误是忘记日期时间类是不可变的，并期望在调用像 plusDays() 这样的方法后原始对象会被修改。

LocalDate myDate = LocalDate.now();
myDate.plusDays(1); // 错误：myDate 没有被修改
System.out.println(myDate); // 仍然是今天的日期

LocalDate myDateCorrect = LocalDate.now();
myDateCorrect = myDateCorrect.plusDays(1); // 正确：将结果赋值给 myDateCorrect
System.out.println(myDateCorrect); // 明天的日期

掌握 Java 8 日期时间 API 可以让你更轻松地处理日期和时间，并避免许多常见的错误。通过本文的学习，相信你已经对 Java 8 日期时间 API 有了更深入的了解。

以上就是《Java8日期时间API教程详解》的详细内容，更多关于java8,localdatetime,LocalDate,DateTimeFormatter,日期时间API的资料请关注golang学习网公众号！