摘要：的操作加減相互比較獲得時(shí)間差。表示一天當(dāng)中的時(shí)間，其精確度到納秒。既包含日期也包含時(shí)間，但是不包含時(shí)區(qū)。此外一個(gè)對(duì)象和一個(gè)對(duì)象可以組合為一個(gè)對(duì)象。表示以天為單位的時(shí)長(zhǎng)，精確到天。

Java 8 出來(lái)很久了，各位也可能已經(jīng)在用了，不過(guò)其中新的時(shí)間日期 API 可能很少人用，甚至不知道怎么上手。本文快速介紹一下其中的主要的類的概念和用法。

Instant 表示一個(gè) EPOCH 時(shí)間戳（即以 0 表示 1970-01-01T00:00:00Z），精確到納秒。Instant 對(duì)象不包含時(shí)區(qū)信息，且值是不可變的。

雖然概念很簡(jiǎn)單，但是它可以很方便的和其他時(shí)間日期對(duì)象之間進(jìn)行交互和轉(zhuǎn)換。比如：

兩個(gè) Instant 可以用來(lái)構(gòu)建一個(gè)時(shí)間段；

一個(gè) Instant 加上一個(gè)時(shí)長(zhǎng)可以得到另一個(gè) Instant；

一個(gè) Instant 加上一個(gè)時(shí)區(qū)可以得到一個(gè) ZonedDateTime 對(duì)象。

首先 Instant 有下面幾個(gè)常量：

Instant.EPOCH 表示 1970-01-01T00:00:00Z

Instant.MIN 表示 Instant 可度量的最早時(shí)間，公元前十億年

Instant.MAX 表示 Instant 可度量的最晚時(shí)間，公元十億年

我們也可以通過(guò)一些靜態(tài)方法來(lái)創(chuàng)建：

Instant.now() 表示當(dāng)前時(shí)間戳

Instant.ofEpochMilli(long milliSec) 通過(guò)現(xiàn)有的毫秒時(shí)間戳來(lái)創(chuàng)建 Instant 對(duì)象

Instant.ofEpochSecond(long seconds) 通過(guò)現(xiàn)有的秒時(shí)間戳來(lái)創(chuàng)建 Instant 對(duì)象

Instant 對(duì)象包含兩個(gè)值：秒數(shù)和納秒數(shù)。其中秒數(shù)指的是 epoch 時(shí)間戳，而納秒數(shù)指的是該秒內(nèi)的納秒時(shí)間。由此可知，Instant 對(duì)象的精確度比 System.currentTimeMillis() 高到不知道哪去了。

所以從 Instant 可以取到兩個(gè)值：Instant.getEpochSecond() 獲取秒數(shù)部分，Instant.getNano() 獲取納秒部分。

加減：plus(), minus()；

相互比較：isAfter(), isBefore()；

獲得時(shí)間差：until()。

下面是幾個(gè)例子：

Instant instant1 = Instant.now();
Instant instant2 = instant1.plus(Duration.ofSeconds(100));        // 添加 100 秒
System.out.println(instant2.isAfter(instant1));                   // true
System.out.println(instant1.until(instant2, ChronoUnit.SECONDS)); // 100

這部分將在后面介紹。

LocalDate 表示年月日，其精確度到天。它是不包含時(shí)分秒的。

LocalTime 表示一天當(dāng)中的時(shí)間，其精確度到納秒。它是不包含年月日的。

LocalDateTime 既包含日期也包含時(shí)間，但是不包含時(shí)區(qū)。它實(shí)際上就是 LocalDate 和 LocalTime 的組合。

這三個(gè)類都有下面的幾個(gè)靜態(tài)方法來(lái)創(chuàng)建對(duì)象：

now() 表示當(dāng)前時(shí)間或日期的對(duì)象；

of() 使用指定的值來(lái)創(chuàng)建；

parse() 通過(guò)解析字符串來(lái)創(chuàng)建。

此外一個(gè) LocalDate 對(duì)象和一個(gè) LocalTime 對(duì)象可以組合為一個(gè) LocalDateTime 對(duì)象。

下面是幾個(gè)例子：

LocalTime localTime = LocalTime.now();
LocalDate localDate = LocalDate.of(2018, 3, 5);
LocalDateTime localDateTime = LocalDateTime.parse("2018-03-05T12:34:56");

// 下面兩句是等價(jià)的
LocalDateTime localDateTime1 = localDate.atTime(localTime);
LocalDateTime localDateTime2 = localTime.atDate(localDate);

此外它們還有各自的創(chuàng)建對(duì)象的靜態(tài)方法，具體請(qǐng)參考 API 文檔。

到了這里你可能發(fā)現(xiàn) LocalDateTime 和 Instance 本質(zhì)上是一樣的，都表示一個(gè)全局跨度內(nèi)的一個(gè)時(shí)間點(diǎn)。那么兩者是否可以互換呢？很可惜，不能直接互換。

因?yàn)?LocalDateTime 沒(méi)有帶時(shí)區(qū)，而 Instance 的時(shí)間戳是統(tǒng)一以格林尼治時(shí)間為準(zhǔn)的，所以相同的 LocalDateTime 在不同時(shí)區(qū)的 EPOCH 時(shí)間戳不同，轉(zhuǎn)換的時(shí)候必須附加一個(gè)時(shí)區(qū)。下面是例子：

// LocalDateTime -> Instant
Instant instant = Instant
        .from(LocalDateTime.now().atZone(ZoneId.systemDefault()));
        
// 或者
Instant instant = Instant.from(ZonedDateTime.now());

// Instant -> LocalDateTime
LocalDateTime localDateTime = LocalDateTime
        .ofInstant(Instant.now(), ZoneId.systemDefault()); 

Duration 表示以秒為單位的時(shí)長(zhǎng)，精確到納秒。Period 表示以天為單位的時(shí)長(zhǎng)，精確到天。

有三類方法可以創(chuàng)建時(shí)長(zhǎng)對(duì)象：

of() 通過(guò)指定的值來(lái)創(chuàng)建；

parse() 通過(guò)解析字符串來(lái)創(chuàng)建；

between() 通過(guò)兩個(gè)時(shí)間點(diǎn)來(lái)創(chuàng)建。

下面是幾個(gè)例子：

Duration duration1 = Duration.between(Instant.EPOCH, Instant.now());
Duration duration2 = Duration.between(LocalTime.parse("00:00:01"), LocalTime.now());
Period period1 = Period.parse("P1Y2M3D");  // 表示一年兩個(gè)月零三天
Period period2 = Period.of(1, 2, 3);       // 同上

注意時(shí)長(zhǎng)可以為負(fù)數(shù)。

之前說(shuō)過(guò)，一個(gè) Instant 加上一個(gè)時(shí)長(zhǎng)可以得到另一個(gè) Instant。下面是個(gè)例子：

Instant then = Instant.now().plus(period);

時(shí)長(zhǎng)與時(shí)長(zhǎng)可以加減。例如 Period period2 = period1.plus(Period.ofDays(1)); 表示 period1 加上一天。

一個(gè)時(shí)間點(diǎn)加上一個(gè)時(shí)長(zhǎng)可以得到另一個(gè)時(shí)間點(diǎn)。例如 LocalDateTime time = LocalDateTime.now().plus(period);。

這里必須注意的一點(diǎn)是，Duration 和 Period 的值不是單個(gè)數(shù)字，而是多個(gè)單位的組合，像 Period 是年月日的組合，比如 “1年零3個(gè)月零5天”，你不能把它看作是 (1 x 365 + 3 x 30 + 5) 天，因?yàn)檫@里可能有閏年和非閏年的區(qū)別。所以 Period.ofYears(1) 是無(wú)法轉(zhuǎn)換為天數(shù)的。

當(dāng)我們要具體計(jì)算兩個(gè)時(shí)間點(diǎn)之間的秒數(shù)或天數(shù)，該怎么辦呢？這里有一個(gè)叫 ChronoUnit 的類。下面是幾個(gè)例子：

// 離那個(gè)什么中華民族的偉大復(fù)興還有多少天
long days = ChronoUnit.DAYS.between(LocalDate.now(), LocalDate.of(2049, 10, 1));

其實(shí) Java 8 的這套時(shí)間 API 比之前的 Date 和 Calendar 都要好懂得多，稍微練習(xí)一下就可以運(yùn)用自如。