8年了，這幾個時間API你用過嗎？

相信Java 8中的LocalDate和LocalDateTime大家都非常熟悉了，這些時間API用起來非常語義化，并且能夠保證線程的安全性。今天介紹另外幾個可能你不常用的時間API以及它們的使用場景，或許能夠幫助你更好地進行開發(fā)。

Instant

最近我使用java.time.Instant比較多，因為計算JWT的過期時間和發(fā)行時間都用的是它。有人會問為什么不使用LocalDateTime呢？其實我也比較納悶。經過一番查詢才明白了為什么要使用Instant。

時間是一條向前不斷延伸的時間線。我們定義過期時間的時候肯定是一個瞬時時間點，而Instant正好可以用來表示時間線上的一個時間戳，常用來記錄事件時間戳。

Instant的范圍需要存儲一個超過long類型極限的數字，因此它被設計為兩個部分：

• seconds?從計算機元年（1970-01-01T00:00:00Z）開始的秒數，可能是負數哦。
• nanos?納秒數，用來修正時間以保證準確性，始終是正數，而且小于999,999,999。

常用API的使用

如果你使用Instant.now()獲取當前時間戳，采用的是UTC時間，并非北京時間。所以需要加上時區(qū)：

?Instant?issuedAt?=?Clock.system(ZoneId.of("Asia/Shanghai")).instant();

TemporalAccessor的實現類，比如常用的LocalDate、LocalDateTime都可以轉換為Instant，例如：

Instant?current?=?Instant.from(LocalDateTime.now());

Instant?instant?=?LocalDateTime.now().toInstant(ZoneOffset.ofHours(8));

如果在計算機元年以前，需要用負值表示：

Instant?instantBefore1970?=?Instant.ofEpochSecond(-13434234,?343434);

還有其它一些API就不一一介紹了，請務必記住，它通常用來記錄事件發(fā)生的瞬時時刻。

Duration

這是一個持續(xù)時間，通常表示持續(xù)了多少時間。它記錄了一個時間量，可以來自一個開始時間和結束時間，也可以來自一些時間計量單位。它同樣用秒數和納秒來存儲時間量，秒數同樣可以是負數，納秒只能是正數。

常用API的使用

比如你花了3天時間寫了個需求：

Duration?days?=?Duration.ofDays(3);

再精確點，從2022年4月2日到2022年4月5日，共3天：

????????Duration?duration?=?Duration.between(LocalDateTime.of(2022,?4,?2,0,0),
????????????????LocalDateTime.of(2022,?4,?5,0,0));

注意這里只能使用能夠表示到秒的Temporal實現，比如LocalDate只能表示到天，是不行的。

?

剩下的持續(xù)了多少年、多少月、多少分鐘、多少小時、多少秒就不一一演示了。

格式化

格式基于?ISO-8601?持續(xù)時間格式PnDTnHnMn.nS?，其中天數被認為是 24 小時。字符串以可選符號開頭，由 ASCII 負號或正號表示。如果為負，則整個周期都被否定。接下來是大寫或小寫的?ASCII?字母“P”。然后有四個部分，每個部分由一個數字和一個后綴組成。這些部分具有“D”、“H”、“M”和“S”的 ASCII 后綴，表示天、小時、分鐘和秒，接受大寫或小寫。后綴必須按順序出現。ASCII 字母“T”必須出現在小時、分鐘或秒部分的第一次出現（如果有）之前。必須存在四個部分中的至少一個，如果存在“T”，則必須在“T”之后至少有一個部分。每個部分的數字部分必須由一個或多個 ASCII 數字組成。該數字可以以 ASCII 負號或正號為前綴。天數、小時數和分鐘數必須解析為long 。秒數必須解析為帶有可選分數的long整數。小數點可以是點或逗號。小數部分可能有 0 到 9 個數字。

實力

Period

說到這里就不得不說一下Period，感覺它和Duration非常類似，只不過它建立在年月日上，以年、月和日為單位對時間量或時間量進行建模。非常容易理解這里就不細說了，記住它最多精確到天就夠了，它同樣是用來記錄持續(xù)時間的，只不過粒度粗了一些。

常用API

持續(xù)了2年:

?Period?years?=?Period.ofYears(2);
//?其它時間單位就不演示了。

這里可以使用周進行初始化：

Period?weeks?=?Period.ofWeeks(3);

新冠從2019年12月持續(xù)到2022年4月

Period?covid19Period?=?Period.between(LocalDate.of(2019,12,1),
????????????????LocalDate.of(2022,4,7));

格式化

基于 ISO-8601 句點格式PnYnMnD和PnW?。字符串以可選符號開頭，由 ASCII 負號或正號表示。如果為負，則整個周期都被否定。接下來是大寫或小寫的 ASCII 字母“P”。然后有四個部分，每個部分由一個數字和一個后綴組成。必須存在四個部分中的至少一個。這些部分具有“Y”、“M”、“W”和“D”的 ASCII 后綴，表示年、月、周和日，接受大寫或小寫。后綴必須按順序出現。每個部分的數字部分必須由 ASCII 數字組成。該數字可以以 ASCII 負號或正號為前綴。該數字必須解析為int?。前導加號/減號和其他單位的負值不是 ISO-8601 標準的一部分。此外，ISO-8601 不允許在PnYnMnD和PnW格式之間混合。任何基于周的輸入乘以 7 并視為天數。

示例：

?

這個感覺用來做日歷計算比較合適一些。

完

避開10個面試大坑，接offer成功率提升至99%

知乎高贊：從源碼層，拆解OracleJDK和OpenJDK有什么區(qū)別？網友：不愧是大神的回答~

開源作者去世后，代碼誰來繼承？

好文章，我在看??