Java ZonedDateTime详解

文
章
目
录

• 1.概述
• 2. 创建ZonedDateTime
• 2.1获取当前时间戳
• 2.2 使用值创建ZonedDateTime
• 3.将字符串解析为ZonedDateTime
• 4.格式化ZonedDateTime
• 5.向ZonedDateTime添加或减去时间

了解Java中的ZonedDateTime类，如何创建其实例以及诸如解析、格式化和添加持续时间和时间段的用例。

1.概述

java.time.ZonedDateTime类是在Java 8日期时间API中引入的，表示带有区域id和区域偏移量信息的ISO-8601日历系统中的日期和时间。该类将所有日期和时间字段存储到纳秒精度。

ZonedDateTime实例可用于将普遍时间线中的实例转换为LocalDateTime，其中差异是区域偏移量，并且偏移量是根据时区规则计算的。请注意，当夏令时（DST）切换时，时区id在一年中可能有不同的偏移量。在这种情况下，ZonedDateTime始终具有该时区的当前偏移量。

我们可以在需要向全球分布式用户表示时间的情况下使用ZonedDateTime实例。例如，我们可以将其用于通信会议日期，与会者将根据其本地日期和时间在线连接。

ZonedDateTime保存的状态相当于三个单独的对象：一个LocalDateTime、一个ZoneId以及解析的ZoneOffset。

ZonedDateTime实例是不可变的，线程安全的。该类定义如下：

public final class ZonedDateTime
    extends Object
    implements Temporal, ChronoZonedDateTime<LocalDate>, Serializable
{
    //类体
}

2. 创建ZonedDateTime

通常，我们将在两种情况下创建ZonedDateTime实例，即获取当前时间戳或创建一个具有特定时区ID和偏移量的时间戳。

2.1获取当前时间戳

使用now()方法获取具有当前时区ID和偏移量的当前时间戳。要获取另一个时区的相同实例，请将时区ID传递给now()方法。

ZonedDateTime now = ZonedDateTime.now();
ZonedDateTime now = ZonedDateTime.now( ZoneId.of(\"GMT+08:00\") );

2.2 使用值创建ZonedDateTime

要使用给定的日期、时间和时区信息创建时间戳，请使用of()方法，该方法接受各种参数以形成实例。

ZoneId zoneId = ZoneId.of(\"UTC+1\");
ZonedDateTime zdt = ZonedDateTime.of(2015, 11, 30, 23, 45, 59, 1234, zoneId);
//从其他local实例创建
LocalDate localDate = LocalDate.of(2019, 03, 12);
LocalTime localTime = LocalTime.of(12,  44);
ZoneId zoneId = ZoneId.of(\"GMT+05:30\");
ZonedDateTime timeStamp = ZonedDateTime.of( localDate, localTime, zoneId );

3.将字符串解析为ZonedDateTime

ZonedDateTime类具有两个重载的parse()方法，将字符串转换为ZonedDateTime实例。

parse(CharSequence text)    //1
parse(CharSequence text, DateTimeFormatter formatter)    //2

• 如果字符串包含ISO_ZONED_DATE_TIME模式中的时间，即2019-03-28T10:15:30+01:00[Europe/Paris]，请使用第一个方法。这是默认模式。
• 对于任何其他日期时间模式，我们需要使用第二个方法，我们将日期时间作为字符串传递，以及表示该日期时间字符串模式的DateTimeFormatter。

//1 - 默认格式
String timeStamp = \"2019-03-27T10:15:30\";
ZonedDateTime localTimeObj = ZonedDateTime.parse(time);
//2 - 指定格式
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(\"yyyy-MM-dd HH:mm:ss a\");
String timeStamp1 = \"2019-03-27 10:15:30 AM\";
ZonedDateTime localTimeObj1 = ZonedDateTime.parse(timeStamp1, formatter);

4.格式化ZonedDateTime

使用ZonedDateTime.format(formatter)方法将实例格式化为所需字符串模式。

DateTimeFormatter formatter = DateTimeFormatter.ofPattern(\"yyyy-MM-dd HH:mm:ss a\");
ZonedDateTime now = ZonedDateTime.now();
String dateTimeString = now.format(formatter);    //2019-03-28 14:47:33 PM

5.向ZonedDateTime添加或减去时间

ZonedDateTime提供了以下方法进行修改。所有方法都返回ZonedDateTime的新实例，因为现有实例始终是不可变的。

• plusYears()
• plusMonths()
• plusDays()
• plusHours()
• plusMinutes()
• plusSeconds()
• plusNanos()
• minusYears()
• minusMonths()
• minusDays()
• minusHours()
• minusMinutes()
• minusSeconds()
• minusNanos()

ZonedDateTime now = ZonedDateTime.now();
//3 小时后
ZonedDateTime zonedDateTime1 = now.plusHours(3);
//3 分钟前
ZonedDateTime zonedDateTime2 = now.minusMinutes(3);
//明年同一时间
ZonedDateTime zonedDateTime2 = now.plusYears(1);
//去年同一时间
ZonedDateTime zonedDateTime2 = now.minusYears(1);

以上就是Java ZonedDateTime详解的全部内容。