天天看點

JDK8中的新時間API:Duration Period和ChronoUnit介紹簡介DurationPeriodChronoUnit

簡介

在JDK8中,引入了三個非常有用的時間相關的API:Duration,Period和ChronoUnit。

他們都是用來對時間進行統計的,本文将會詳細講解一下這三個API的使用。

Duration

Duration主要用來衡量秒級和納秒級的時間,使用于時間精度要求比較高的情況。

先來看看Duration的定義:

public final class Duration
        implements TemporalAmount, Comparable<Duration>, Serializable           

可以看到,Duration是一個final class,并且它是可序列化和可比較的。我們注意,Duration還實作了TemporalAmount接口。

那麼TemporalAmount接口是什麼呢?

TemporalAmount是Duration和Period的父接口。

JDK8中的新時間API:Duration Period和ChronoUnit介紹簡介DurationPeriodChronoUnit

它定義了4個必須要實作的方法:

long get(TemporalUnit unit);
List<TemporalUnit> getUnits();
Temporal addTo(Temporal temporal);
Temporal subtractFrom(Temporal temporal);           

其中TemporalUnit代表的是時間對象的機關,比如:years, months, days, hours, minutes 和 seconds.

而Temporal代表的是對時間對象的讀寫操作。

我們看下Duration的一些基本操作:

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(時間機關)。

看下執行結果:

INFO com.flydean.time - 60
 INFO com.flydean.time - 120000000
 INFO com.flydean.time - [Seconds, Nanos]           

除了Instance,我們還可以使用LocalTime:

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來判斷兩個時間的先後順序:

duration.plusSeconds(60);
duration.minus(30, ChronoUnit.SECONDS);
log.info("{}",duration.isNegative());           

除此之外,我們友善的使用Duration.of方法來友善的建立Duration:

Duration fromDays = Duration.ofDays(1);
Duration fromMinutes = Duration.ofMinutes(60);           

Period

Period的機關是year, month 和day 。

操作基本上和Duration是一緻的。

先看下定義:

public final class Period
        implements ChronoPeriod, Serializable            

其中ChronoPeriod是TemporalAmount的子接口。

同樣的,我們可以使用Period.between從LocalDate來建構Period:

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來建構:

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的操作:

period.plusDays(50);
period.minusMonths(2);           

ChronoUnit

ChronoUnit是用來表示時間機關的,但是也提供了一些非常有用的between方法來計算兩個時間的內插補點:

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

本文作者:flydean程式那些事

本文連結:

http://www.flydean.com/duration-period-chronounit/

本文來源:flydean的部落格

歡迎關注我的公衆号:「程式那些事」最通俗的解讀,最深刻的幹貨,最簡潔的教程,衆多你不知道的小技巧等你來發現!