Java8 时间 API

前言

Java8 中最为人津津乐道的新改变恐怕当属函数式 API 的加入。但实际上，Java8 所加入的新功能远不止这个。 本文将基于《Java SE8 for the Really Impatient》的第 5 章，归纳一下 Java8 加入的位于java.time包下的日期和时间 API。

时间点与时间间隔

在我们常说的四维空间体系中，时间轴往往作为除长宽高三轴以外的第四轴。时间轴由无穷多个时间点组成，而两个时间点之间的距离组成一个时间间隔。相较于我们常说的日期、时间，时间点本身所携带的信息是很少的，不会携带如时区等冗余的信息。作为时间轴上的一个点，我们可以将它称为绝对时间。

Java8 引入了 Instant 类（瞬时）来表示时间轴上的一个点。Instant 的构造方法是 private 的，我们只能通过调用它的静态工厂方法来产生一个 Instant 实例。其中最常用的是 Instant.now() 方法，返回当前的时间点。Instant 类也实现了 comparesTo 和 equals 方法来对比两个瞬时点。

通过调用 Duration.between() 方法我们便可以计算两个时间点之间的时间间隔：

between 方法返回一个 Duration 实例。Duration 内部以 long 成员来存储时间间隔信息，最小单位可去到纳秒，同时提供了如 toMillis、toSeconds 等方法。

Instant 和 Duration 类常用的方法包括如下：

注意：Instant 类和 Duration 类都是不可变的，上述方法都会返回一个新的实例。

本地日期

在新的时间 API 中，Java 提供了两种时间格式：不带时区信息的本地时间和带时区的时间。本地日期表示一个日期，而本地时间还包含（一天中的）时间，但它们都不包含任何有关时区的信息。 例如，June 14, 1903 就是一个本地日期。由于日期不含一天中的时间，也不含时区信息，所以它无法与一个准确的瞬时点对应。相反，July 16, 1969, 09:32:00 EDT 就是一个带时区的时间， 它表示了时间轴上准确的一点。但有很多计算是不需要考虑时区的，在某些情况下考虑时区甚至可能导致错误的结果。出于此原因，API 设计者们更推荐使用不带时区的时间，除非你真的需要这个时区信息。

LocalDate就是一个不带时区的本地日期：它只带有年份、月份和当月的天数。你可以通过LocalDate的静态工厂方法now或of来创建一个实例：

这里我们看到，静态工厂方法中指示月份的数字是以1开始的，因此6就代表着六月。如果你实在是太喜欢以0开始，无法接受这种设定，你也可以使用枚举类型Month来指定月份。

下表中列出了LocalDate对象的一些常用方法。详细的方法说明请参考LocalDate的 JavaDoc。

注意：LocalDate 类是不可变的，上述方法都会返回一个新的实例。

在上一节中我们提到，两个瞬时点Instant之间的是一个持续时间Duration。对于本地时间，对应的对象就是时段Period， 它表示一段逝去的年月日。

本地时间

LocalTime代表一天中的某个时间，例如下午3点30分。 同样，你可以通过LocalTime的静态工厂方法now和of来创建一个实例。

下表中列出了LocalTime对象的一些常用方法。详细的方法说明请参考LocalTime的 JavaDoc。

注意：LocalTime 类是不可变的，上述方法都会返回一个新的实例。

LocalDateTime类则可看作是LocalDate和LocalTime的结合。它用于存储本地时区中的某个时间点，包含当前的年月日等日期信息， 同时也包含了时钟、分钟、秒钟等时间信息。同样，LocalDateTime也是不可变的。

详细的方法说明请参考LocalDateTime的 JavaDoc。

带时区的时间

Java8 的时间 API 当然也加入了对时区的支持。分别对应着LocalDate、LocalTime和LocalDateTime，带时区的时间类为ZonedDate、 ZonedTime、ZonedDateTime。

Java 中的时区信息来自于 IANA（Internet Assigned Numbers Authority）的数据库，其中每个时区都有着对应的 ID，例如America/New_York或者Europe/Berlin。 调用ZoneId.getAvailableIds方法即可获取所有可用的时区信息。

你还可以使用ZoneId.of(id)方法，用指定的时区 ID 来获取对应的ZoneId对象。通过调用local.atZone(zoneId)方法， 你可以将一个LocalDateTime转换成一个ZonedDateTime对象，或者通过调用静态方法ZonedDateTime.of来创建一个对象。

ZonedDateTime的许多方法都与LocalDateTime一致。下表中列出了ZonedDateTime特有的常用方法，详细的方法说明请参考ZonedDateTime的 JavaDoc。

除此之外，Java8 还提供了一个OffsetDateTime类，用来表示带有（与 UTC 相比的）偏移量的时间。这个类专门用于一些不需要时区规则的业务场景， 比如某些网络协议。对于人类可读的时间，ZonedDateTime是更好的选择。

详情请查阅OffsetDateTime的 JavaDoc。

日期校正器

有些时候，我们可以能需要得到类似“每月的第一个星期二”这样的日期。Java8 提供了TemporalAdjuster接口，用以实现自定义的日期校正逻辑。 通过将创建好的TemporalAdjuster传递给日期时间类的with方法便可在原有日期时间对象的基础上产生出一个符合要求的日期时间。 例如，你可以通过如下代码来计算下一个星期二：

此处利用 Lambda 表达式快速实现了一个匿名的TemporalAdjuster对象。注意 Lambda 表达式的参数类型为 Temporal， 某些LocalDate或者LocalDateTime之类的类特有的方法将不可用，在使用前必须进行强制转换。 你可以通过ofDateAdjuster方法和一个UnaryOperator<LocalDate>来避免强制转换：

上述代码中使用的ofDateAdjuster方法来自类TemporalAdjusters。实际上这个类通过静态方法提供了大量的常用TemporalAdjuster实现。 比如，我们也可以通过如下代码来计算下一个星期二：

下表中列出了TemporalAdjusters的一些常用方法。详细的方法说明请参考TemporalAdjusters的JavaDoc。

格式化和解析

除了日期校正，日期与字符串之间的相互转换也是十分常见的操作。对于原有的java.util.Date等类，我们使用java.text.DateFormat来对日期进行格式化和解析。 对于 Java8 新引入的日期时间类，我们使用java.time.format.DateTimeFormatter类。

DateTimeFormatter类提供了三种格式化方法来打印日期时间：

• 预定义的标准格式
• 语言环境相关的格式
• 自定义的格式

下表中列出了所有预定义的DateTimeFormatter。详细说明可参考DateTimeFormatter的 JavaDoc。

通过调用DateTimeFormatter类的format方法即可对日期进行格式化：

标准格式主要用于机器可读的时间戳。为了产生人类可读的日期和时间，你需要使用语言环境相关的格式。 下表中列出了 Java8 提供的 4 种风格：

你可以通过静态方法ofLocalizedDate、ofLocalizedTime和ofLocalizedDateTime来创建这些格式：

这些方法使用的都是默认的语言环境。通过使用withLocale方法可以更改为其他语言环境：

你可以通过调用formatter.toFormat()方法来获取一个等效的java.util.DateFormat对象。

最后，你可以通过指定的模式来自定义日期的格式。例如：

其中不同的符号对应着不同的含义。下表中列出了不同符号的具体含义和实例，详情可查阅DateTimeFormatter的 JavaDoc。

要从一个字符串中解析出日期时间，可以使用静态方法parse的各个重载方法。例如：

与遗留代码互操作

尽管使用全新的 API 可以获得更好的开发体验，但兼容遗留代码总是不可避免的。因此，熟知新的日期时间类和旧的日期时间类之间的转换方法也是我们必须学习的。

总体来讲，转换规则可以归纳为下表：