拨开荷叶行,寻梦已然成。仙女莲花里,翩翩白鹭情。
IMG-LOGO
主页 文章列表 在LocalDateTime 和ZonedDateTime 之间转换

在LocalDateTime 和ZonedDateTime 之间转换

白鹭 - 2022-12-26 2167 0 2

一、概述

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对象。该方法接受LocalDateTimeZoneId的实例作为参数并返回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()方法接受LocalDateTimeZoneOffSetZoneId对像作为参数:

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对像是从通过组合LocalDateTimeZoneOffSet对象隐式形成的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()方法通过严格验证LocalDateTimeZoneOffSetZoneID参数的组合返回一个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/TokyoZoneId和表示默认UTC ( GMT + 0) 的ZoneOffSet值的组合创建ZonedDateTime对象时,会抛出异常。

3. 将ZonedDateTime转换为LocalDateTime

ZonedDateTime对象维护三个不同的对象:LocalDateTimeZoneIdZoneOffset

我们可以使用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,反之亦然。


标签:

0 评论

发表评论

您的电子邮件地址不会被公开。 必填的字段已做标记 *