logo头像

From zero to HERO

Java 8时间API中的Instant、Duration、Period

相信Java 8中的LocalDateLocalDateTime大家都非常熟悉了,这些时间API用起来非常语义化,并且能够保证线程的安全性。今天介绍另外几个可能你不常用的时间API以及它们的使用场景,或许能够帮助你更好地进行开发。

Instant

最近我使用java.time.Instant比较多,因为计算JWT的过期时间和发行时间都用的是它。有人会问为什么不使用LocalDateTime呢?其实我也比较纳闷。经过一番查询才明白了为什么要使用Instant

时间是一条向前不断延伸的时间线。我们定义过期时间的时候肯定是一个瞬时时间点,而Instant正好可以用来表示时间线上的一个时间戳,常用来记录事件时间戳。

Instant的的范围需要存储一个超过long类型极限的数字,因此它被设计为两个部分:

  • seconds 从计算机元年(1970-01-01T00:00:00Z)开始的秒数,可能是负数哦。
  • nanos 纳秒数,用来修正时间以保证准确性,始终是正数,而且小于999,999,999

常用API的使用

如果你使用Instant.now()获取当前时间戳,采用的是UTC时间,并非北京时间。所以需要加上时区:

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

如果在计算机元年以前,需要用负值表示:

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

还有其它一些API就不一一介绍了,请务必记住,它通常用来记录事件发生的瞬时时刻。

Duration

这是一个持续时间,通常表示持续了多少时间。它记录了一个时间量,可以来自一个开始时间和结束时间,也可以来自一些时间计量单位。它同样用秒数纳秒来存储时间量,秒数同样可以是负数,纳秒只能是正数。

常用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只能表示到天,是不行的。

剩下的持续了多少年、多少月、多少分钟、多少小时、多少秒就不一一演示了。

格式化

格式基于 ISO-8601 持续时间格式PnDTnHnMn.nS ,其中天数被认为是 24 小时。字符串以可选符号开头,由 ASCII 负号或正号表示。如果为负,则整个周期都被否定。接下来是大写或小写的 ASCII 字母“P”。然后有四个部分,每个部分由一个数字和一个后缀组成。这些部分具有“D”、“H”、“M”和“S”的 ASCII 后缀,表示天、小时、分钟和秒,接受大写或小写。后缀必须按顺序出现。 ASCII 字母“T”必须出现在小时、分钟或秒部分的第一次出现(如果有)之前。必须存在四个部分中的至少一个,如果存在“T”,则必须在“T”之后至少有一个部分。每个部分的数字部分必须由一个或多个 ASCII 数字组成。该数字可以以 ASCII 负号或正号为前缀。天数、小时数和分钟数必须解析为long 。秒数必须解析为带有可选分数的long整数。小数点可以是点或逗号。小数部分可能有 0 到 9 个数字。

实力

格式 含义
PT20.345S 20.345秒
PT15M 15分钟
PT10H 10小时
P2D 2天
P2DT3H4M 2天3小时4分钟
P-6H3M 减6小时加3分钟,等于减5小时57分钟
-P6H3M 否定全部,减6小时3分钟
-P-6H+3M 加6小时减3分钟,等于持续5小时57分钟

Period

说到这里就不得不说一下Period,感觉它和Duration非常类似,只不过它建立在年月日上,以年、月和日为单位对时间量或时间量进行建模。非常容易理解这里就不细说了,记住它最多精确到天就够了,它同样是用来记录持续时间的,只不过粒度粗了一些。

常用API

持续了2年:

 Period years = Period.ofYears(2);
// 其它时间单位就不演示了。

这里可以使用周进行初始化:

Period weeks = Period.ofWeeks(3);

新冠从2019年12月持续到2022年4月

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

格式化

基于 ISO-8601 句点格式PnYnMnDPnW 。字符串以可选符号开头,由 ASCII 负号或正号表示。如果为负,则整个周期都被否定。接下来是大写或小写的 ASCII 字母“P”。然后有四个部分,每个部分由一个数字和一个后缀组成。必须存在四个部分中的至少一个。这些部分具有“Y”、“M”、“W”和“D”的 ASCII 后缀,表示年、月、周和日,接受大写或小写。后缀必须按顺序出现。每个部分的数字部分必须由 ASCII 数字组成。该数字可以以 ASCII 负号或正号为前缀。该数字必须解析为int
前导加号/减号和其他单位的负值不是 ISO-8601 标准的一部分。此外,ISO-8601 不允许在PnYnMnDPnW格式之间混合。任何基于周的输入乘以 7 并视为天数。

示例:

格式 含义
P2Y 两年
P3M 仨月
P4W 四周
P5D 五天
P1Y2M3D 一年俩月零3天
P1Y2M3W4D 一年俩月三周零四天,Period.of(1, 2, 25),3x7+4=25
P-1Y2M Period.of(-1, 2, 0)
-P1Y2M Period.of(-1, -2, 0)

这个感觉用来做日历计算比较合适一些。

评论系统未开启,无法评论!