JDK8中的新時間API:Duration Period和ChronoUnit介紹
阿新 • • 發佈：2020-11-05
[toc]
# 簡介
在JDK8中，引入了三個非常有用的時間相關的API：Duration，Period和ChronoUnit。
他們都是用來對時間進行統計的，本文將會詳細講解一下這三個API的使用。
# Duration
Duration主要用來衡量秒級和納秒級的時間，使用於時間精度要求比較高的情況。
先來看看Duration的定義：
~~~java
public final class Duration
implements TemporalAmount, Comparable, Serializable
~~~
可以看到，Duration是一個final class，並且它是可序列化和可比較的。我們注意，Duration還實現了TemporalAmount介面。
那麼TemporalAmount介面是什麼呢？
TemporalAmount是Duration和Period的父介面。
它定義了4個必須要實現的方法：
~~~java
long get(TemporalUnit unit);
List getUnits();
Temporal addTo(Temporal temporal);
Temporal subtractFrom(Temporal temporal);
~~~
其中TemporalUnit代表的是時間物件的單位，比如：years, months, days, hours, minutes 和 seconds.
而Temporal代表的是對時間物件的讀寫操作。
我們看下Duration的一些基本操作：
~~~java
Instant start = Instant.parse("2020-08-03T10:15:30.00Z");
Instant end = Instant.parse("2020-08-03T10:16:30.12Z");
Duration duration = Duration.between(start, end);
log.info("{}",duration.getSeconds());
log.info("{}",duration.getNano());
log.info("{}",duration.getUnits());
~~~
上面我們建立了兩個Instant，然後使用Duration.between方法來測算他們之間的差異。
其中秒部分的差異，使用duration.getSeconds()來獲取，而秒以下精度部分的差異，我們使用duration.getNano()來獲取。
最後我們使用duration.getUnits()來看一下duration支援的TemporalUnit（時間單位）。
看下執行結果：
~~~java
INFO com.flydean.time - 60
INFO com.flydean.time - 120000000
INFO com.flydean.time - [Seconds, Nanos]
~~~
除了Instance，我們還可以使用LocalTime：
~~~java
LocalTime start2 = LocalTime.of(1, 20, 25, 1314);
LocalTime end2 = LocalTime.of(3, 22, 27, 1516);
Duration.between(start2, end2).getSeconds();
~~~
我們還可以對Duration做plus和minus操作，並且通過使用isNegative來判斷兩個時間的先後順序：
~~~java
duration.plusSeconds(60);
duration.minus(30, ChronoUnit.SECONDS);
log.info("{}",duration.isNegative());
~~~
除此之外，我們方便的使用Duration.of方法來方便的建立Duration：
~~~java
Duration fromDays = Duration.ofDays(1);
Duration fromMinutes = Duration.ofMinutes(60);
~~~
# Period
Period的單位是year, month 和day 。
操作基本上和Duration是一致的。
先看下定義：
~~~java
public final class Period
implements ChronoPeriod, Serializable
~~~
其中ChronoPeriod是TemporalAmount的子介面。
同樣的，我們可以使用Period.between從LocalDate來構建Period：
~~~java
LocalDate startDate = LocalDate.of(2020, 2, 20);
LocalDate endDate = LocalDate.of(2021, 1, 15);
Period period = Period.between(startDate, endDate);
log.info("{}",period.getDays());
log.info("{}",period.getMonths());
log.info("{}",period.getYears());
~~~
也可以直接從Period.of來構建：
~~~java
Period fromUnits = Period.of(3, 10, 10);
Period fromDays = Period.ofDays(50);
Period fromMonths = Period.ofMonths(5);
Period fromYears = Period.ofYears(10);
Period fromWeeks = Period.ofWeeks(40);
~~~
最後我們還可以使用plus或者minus的操作：
~~~java
period.plusDays(50);
period.minusMonths(2);
~~~
# ChronoUnit
ChronoUnit是用來表示時間單位的，但是也提供了一些非常有用的between方法來計算兩個時間的差值：
~~~java
LocalDate startDate = LocalDate.of(2020, 2, 20);
LocalDate endDate = LocalDate.of(2021, 1, 15);
long years = ChronoUnit.YEARS.between(startDate, endDate);
long months = ChronoUnit.MONTHS.between(startDate, endDate);
long weeks = ChronoUnit.WEEKS.between(startDate, endDate);
long days = ChronoUnit.DAYS.between(startDate, endDate);
long hours = ChronoUnit.HOURS.between(startDate, endDate);
long minutes = ChronoUnit.MINUTES.between(startDate, endDate);
long seconds = ChronoUnit.SECONDS.between(startDate, endDate);
long milis = ChronoUnit.MILLIS.between(startDate, endDate);
long nano = ChronoUnit.NANOS.between(startDate, endDate);
~~~
本文的例子: [learn-java-base-9-to-20](https://github.com/ddean2009/learn-java-base-9-to-20/tree/master/java-base)
> 本文作者：flydean程式那些事
>
> 本文連結：[http://www.flydean.com/duration-period-chronounit/](http://www.flydean.com/duration-period-chronounit/)
>
> 本文來源：flydean的部落格
>
> 歡迎關注我的公眾號:「程式那些事」最通俗的解讀，最深刻的乾貨，最簡潔的教程，眾多你不知道的小技巧等你來發現！