cn.hutool.core.date

Class TemporalUtil

java.lang.Object

cn.hutool.core.date.TemporalUtil

Direct Known Subclasses:

TemporalAccessorUtil

public class TemporalUtil
extends Object

Temporal 工具类封装

Since:

5.4.5

Author:

looly

Constructor Summary

Constructors

Constructor and Description
TemporalUtil()

Method Summary

Modifier and Type	Method and Description
static Duration	between(Temporal startTimeInclude, Temporal endTimeExclude) 获取两个日期的差，如果结束时间早于开始时间，获取结果为负。
static long	between(Temporal startTimeInclude, Temporal endTimeExclude, ChronoUnit unit) 获取两个日期的差，如果结束时间早于开始时间，获取结果为负。
<T extends Temporal> T	offset(T temporal, DayOfWeek dayOfWeek, boolean isPrevious) 偏移到指定的周几
static <T extends Temporal> T	offset(T time, long number, TemporalUnit field) 日期偏移,根据field不同加不同值（偏移会修改传入的对象）
static ChronoUnit	toChronoUnit(TimeUnit unit) 将 TimeUnit 转换为 ChronoUnit.
static TimeUnit	toTimeUnit(ChronoUnit unit) 转换 ChronoUnit 到 TimeUnit.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TemporalUtil

public TemporalUtil()

Method Detail

between

public static Duration between(Temporal startTimeInclude,
                               Temporal endTimeExclude)

获取两个日期的差，如果结束时间早于开始时间，获取结果为负。

返回结果为Duration对象，通过调用toXXX方法返回相差单位

Parameters:

startTimeInclude - 开始时间（包含）

endTimeExclude - 结束时间（不包含）

Returns:

时间差 Duration对象

between

public static long between(Temporal startTimeInclude,
                           Temporal endTimeExclude,
                           ChronoUnit unit)

获取两个日期的差，如果结束时间早于开始时间，获取结果为负。

返回结果为时间差的long值

Parameters:

startTimeInclude - 开始时间（包括）

endTimeExclude - 结束时间（不包括）

unit - 时间差单位

Returns:

时间差

toChronoUnit

public static ChronoUnit toChronoUnit(TimeUnit unit)
                               throws IllegalArgumentException

将 TimeUnit 转换为 ChronoUnit.

Parameters:

unit - 被转换的TimeUnit单位，如果为null返回null

Returns:

ChronoUnit

Throws:

IllegalArgumentException

Since:

5.7.16

toTimeUnit

public static TimeUnit toTimeUnit(ChronoUnit unit)
                           throws IllegalArgumentException

转换 ChronoUnit 到 TimeUnit.

Parameters:

unit - ChronoUnit，如果为null返回null

Returns:

TimeUnit

Throws:

IllegalArgumentException - 如果TimeUnit没有对应单位抛出

Since:

5.7.16

offset

public static <T extends Temporal> T offset(T time,
                                            long number,
                                            TemporalUnit field)

日期偏移,根据field不同加不同值（偏移会修改传入的对象）

Type Parameters:

T - 日期类型，如LocalDate或LocalDateTime

Parameters:

time - Temporal

number - 偏移量，正数为向后偏移，负数为向前偏移

field - 偏移单位，见ChronoUnit，不能为null

Returns:

偏移后的日期时间

offset

public <T extends Temporal> T offset(T temporal,
                                     DayOfWeek dayOfWeek,
                                     boolean isPrevious)

偏移到指定的周几

Type Parameters:

T - 日期类型，如LocalDate或LocalDateTime

Parameters:

temporal - 日期或者日期时间

dayOfWeek - 周几

isPrevious - 是否向前偏移，true向前偏移，false向后偏移。

Returns:

偏移后的日期

Since:

5.8.0