在LocalDateTime 和ZonedDateTime 之间转换-编程知识-白鹭情

一、概述

Java LocalDateTimeAPI 表示和操作日期和时间的组合。ZonedDateTime是一个不可变的对象，它包含精度为纳秒的日期时间值、基于ISO 8601 日历系统的时区值，以及用于处理不明确的本地日期时间的ZoneOffSet。

在本教程中，我们将了解如何将LocalDateTime转换为ZonedDateTime，反之亦然。

2. 将`LocalDateTime`转换为`ZonedDateTime`

让我们首先将LocalDateTime的实例转换为ZonedDateTime.

2.1.使用`atZone()`方法

LocalDateTime实例中的atZone()方法执行到ZonedDateTime的转换并保持相同的日期时间值：

LocalDateTime localDateTime = LocalDateTime.of(2022, 1, 1, 0, 30, 22);
 ZonedDateTime zonedDateTime = localDateTime.atZone(ZoneId.of("Canada/Atlantic"));
 assertEquals(localDateTime.getYear(), zonedDateTime.getYear());
 assertEquals(localDateTime.getMonth(), zonedDateTime.getMonth());
 assertEquals(localDateTime.getDayOfMonth(), zonedDateTime.getDayOfMonth());
 assertEquals(localDateTime.getHour(), zonedDateTime.getHour());
 assertEquals(localDateTime.getMinute(), zonedDateTime.getMinute());
 assertEquals(localDateTime.getSecond(), zonedDateTime.getSecond());

atZone()方法接收ZoneId值，该值指定基于ISO 8601 日历系统的时区。

调用withZoneSameInstant()方法使用ZoneOffSet时差转换为实际的日期时间值：

LocalDateTime localDateTime = LocalDateTime.of(2022, 1, 1, 0, 30, 22);
 ZonedDateTime zonedDateTime = localDateTime.atZone(ZoneId.of("Africa/Lagos")).withZoneSameInstant(ZoneId.of("Canada/Atlantic"));
 assertEquals("2021-12-31T19:30:22-04:00[Canada/Atlantic]", zonedDateTime.toString());
 assertEquals("-04:00", zonedDateTime.getOffset().toString());

我们可以通过调用静态ZoneId.getAvailableZoneIds()方法来获取可用的ZoneId。此方法返回一组所有可用的基于区域的ID，作为Strings，我们可以从中选择以创建ZoneId对象。

此外，使用atZone()进行的转换还带有一个ZoneOffSet值，该值提供ZonedDateTime对象与UTC (GMT) 之间的时差（上例中的-04:00）。

2.2.使用`ZonedDateTime.of()`方法

ZonedDateTime类还提供了一个静态of()方法来创建ZonedDateTime对象。该方法接受LocalDateTime和ZoneId的实例作为参数并返回ZonedDateTime对象：

LocalDateTime localDateTime = LocalDateTime.of(2022, 11, 5, 7, 30, 22);
 ZonedDateTime zonedDateTime = ZonedDateTime.of(localDateTime, ZoneId.of("Africa/Accra")).withZoneSameInstant(ZoneId.of("Africa/Lagos"));
 assertEquals("2022-11-05T08:30:22+01:00[Africa/Lagos]", zonedDateTime.toString());
 assertEquals(localDateTime.getYear(), zonedDateTime.getYear());

在这种情况下，正如我们之前看到的，我们也可以通过调用withZoneSameInstant()方法来获取给定区域的实际日期时间值。

2.3.使用`ZonedDateTime.ofInstant()`方法

我们还可以结合使用ZoneOffSet对象和LocalDateTime来创建ZonedDateTime对象。

静态ofInstant()方法接受LocalDateTime、ZoneOffSet和ZoneId对像作为参数：

LocalDateTime localDateTime = LocalDateTime.of(2022, 1, 5, 17, 30, 22);
 ZoneId zoneId = ZoneId.of("Africa/Lagos");
 ZoneOffset zoneOffset = zoneId.getRules().getOffset(localDateTime);
 ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(localDateTime, zoneOffset, zoneId);

assertEquals("2022-01-05T17:30:22+01:00[Africa/Lagos]", zonedDateTime.toString());

ZonedDateTime对像是从通过组合LocalDateTime和ZoneOffSet对象隐式形成的Instant对象创建的。

2.4.使用`ZonedDateTime.ofLocal()`方法

静态的ofLocal()方法从LocalDateTime对象创建一个ZonedDateTime，并将首选的ZoneOffSet对像作为参数传递：

LocalDateTime localDateTime = LocalDateTime.of(2022, 8 , 25, 8, 35, 22);
 ZoneId zoneId = ZoneId.of("Africa/Lagos");
 ZoneOffset zoneOffset = zoneId.getRules().getOffset(localDateTime);
 ZonedDateTime zonedDateTime = ZonedDateTime.ofLocal(localDateTime, zoneId, zoneOffset);

assertEquals("2022-08-25T08:35:22+01:00[Africa/Lagos]", zonedDateTime.toString());

通常，本地日期时间只存在一个有效偏移量。当发生时间重叠时，将有两个有效偏移量。

如果作为参数传递的首选ZoneOffset是有效偏移量之一，则使用它。否则，转换将保持先前的有效偏移量。

2.5.使用`ZonedDateTime.ofStrict()`方法

同样，静态ofStrict()方法通过严格验证LocalDateTime、ZoneOffSet和ZoneID参数的组合返回一个ZonedDateTime对象：

LocalDateTime localDateTime = LocalDateTime.of(2022, 12, 25, 6, 18, 2);
 ZoneId zoneId = ZoneId.of("Asia/Tokyo");
 ZoneOffset zoneOffset = zoneId.getRules().getOffset(localDateTime);
 ZonedDateTime zonedDateTime = ZonedDateTime.ofStrict(localDateTime, zoneOffset, zoneId);

assertEquals("2002-12-25T06:18:02+09:00[Asia/Tokyo]", zonedDateTime.toString());

如果我们提供无效的参数组合，该方法将抛出DateTimeException：

zoneId = ZoneId.of("Asia/Tokyo");
 zoneOffset = ZoneOffset.UTC;
 assertThrows(DateTimeException.class, () -> ZonedDateTime.ofStrict(localDateTime, zoneOffset, zoneId));

上面的示例表明，当我们尝试使用Asia/Tokyo的ZoneId和表示默认UTC ( GMT + 0) 的ZoneOffSet值的组合创建ZonedDateTime对象时，会抛出异常。

3. 将`ZonedDateTime`转换为`LocalDateTime`

ZonedDateTime对象维护三个不同的对象：LocalDateTime、ZoneId和ZoneOffset。

我们可以使用toLocalDateTime()方法将ZonedDateTime的实例转换为LocalDateTime：

ZonedDateTime zonedDateTime = ZonedDateTime.of(2011, 2, 12, 6, 14, 1, 58086000, ZoneId.of("Asia/Tokyo"));
 LocalDateTime localDateTime = zonedDateTime.toLocalDateTime();
 assertEquals("2011-02-12T06:14:01.058086+09:00[Asia/Tokyo]", zonedDateTime.toString());

此方法检索作为ZonedDateTime属性的一部分存储的LocalDateTime对象。

4。结论

在本文中，我们了解了如何将LocalDateTime的实例转换为ZonedDateTime，反之亦然。