lostars
发布于 2018-05-08 / 3000 阅读
0

JAVA 8 DURATION 详解

最近发现spring boot中的有些配置使用了Duration,于是详细的看了Duration这个类

Duration是在Java8中加入的,主要是用来计算日期,差值之类的。
Duration被声明final(immutable),并且线程安全。

先看下Duration的实例化方式,由于构造器被私有了,对外只提供了一个ZERO实例,主要是使用静态工厂方法来进行实例化

  • 自定义初始化方式,这种方式主要是以一系列of…()方法为主,可以自定义时分秒。
    of(long amount, TemporalUnit unit) 在ZERO的基础上加上一定时间,第一个参数指定数量,第二个指定单位,单位可使用ChronoUnit(实现了TemporalUnit)
    from(TemporalAmount amount) 通过TemporalAmount获取一个Duration实例,也是在ZERO的基础上增加
  • 转换字符串方式,类似于SimpleDateFormat的格式化日期方式
    Duration字符串类似数字有正负之分,默认正,负以’-‘开头,紧接着’P’,下面所有字母都不区分大小写:
    ‘D’ – 天
    ‘H’ – 小时
    ‘M’ – 分钟
    ‘S’ – 秒
    字符’T’是紧跟在时分秒之前的,每个单位都必须由数字开始,且时分秒顺序不能乱,比如:P2DT3M5S,P3D,PT3S
    PT3M2S 等于 -PT-3M-2S
  • 通过日期获取,这种方式实现是 between(Temporal startInclusive, Temporal endExclusive) 方法,该方法获取两个时间段的Duration实例,Temporal有多种实现,其中就有jdk1.8中添加的LocalTime等等
    下面介绍基本的公共方法,主要是对Duration做一些基本操作:

时间转换为时分秒:toSeconds(),to…()等方法
两个Duration比较:compareTo()相等返回0,大于返回正数,小于返回负数
获取指定单位的数值:get(TemporalUnit unit)
获取Duration中所有单位:getUnits()
获取Duration绝对值:abs()
给指定Temporal添加一个Duration:addTo(Temporal temporal)

getNano() 获取纳秒数,获取的是纳秒部分的值,而不是转换成纳秒
getSeconds() 获取秒数,获取的是秒部分的值,而不是转换成秒

plusSeconds(), plus…() 加法 增加时间(时分秒),返回新实例
dividedBy(long divisor) 除法,返回一个新的Duration实例,内部转换成秒来实现
multipliedBy(long multiplicand) 惩罚,返回一个新的Duration实例,内部同样也是转换成秒来实现
minus…()相关方法 减法:注意是用你输入参数去减,返回的是新的Duration实例
四则运算都是返回的新实例,并没有对旧实例进行修改,这是需要注意的,所以千万别忽略了返回值。

返回一个负的Duration实例:negated() 比如 PT1.4S 返回 PT-1.4S
isZero() 判断是否是 ZERO 实例

withSeconds() 和 withNanos() 两个方法通过传入秒数或者纳秒数来构造一个Duration副本

最后来看下Duration实现原理,其实很简单,Duration内部维护了 seconds 和 nanos 两个内部 long 型变量用来记录实际的Duration值,上面的所有操作其实基本都是对这两个内部变量的操作。
构造Duration实例中核心方法是:

private static Duration create(long seconds, int nanoAdjustment) {
 if ((seconds | nanoAdjustment) == 0) {
 return ZERO;
 }
 return new Duration(seconds, nanoAdjustment);
}

从这里也可以看出对Duration的实例化,其实就是对内部两个变量的一个赋值操作。

最后总结一下Duration最实用的一个功能其实是 between 方法,因为有很多时候我们需要计算两个日期之间的天数或者小时数,用这个就可以很方便的进行操作。