Package org.miaixz.bus.core.center.date

Class Between

java.lang.Object

org.miaixz.bus.core.center.date.Between

All Implemented Interfaces:

Serializable

public class Between
extends Object
implements Serializable

日期间隔

Since:

Java 17+

Author:

Kimi Liu

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
Between(Date begin, Date end)	构造 在前的日期做为起始时间，在后的做为结束时间，间隔只保留绝对值正数
Between(Date begin, Date end, boolean isAbs)	构造 在前的日期做为起始时间，在后的做为结束时间

Method Summary

Modifier and Type	Method	Description
static Period	between(LocalDate startTimeInclude, LocalDate endTimeExclude)	获取两个日期的表象时间差，如果结束时间早于开始时间，获取结果为负。
static Duration	between(LocalDateTime startTimeInclude, LocalDateTime endTimeExclude)	获取两个日期的差，如果结束时间早于开始时间，获取结果为负 返回结果为Duration对象，通过调用toXXX方法返回相差单位
static long	between(LocalDateTime startTimeInclude, LocalDateTime endTimeExclude, ChronoUnit unit)	获取两个日期的差，如果结束时间早于开始时间，获取结果为负 返回结果为时间差的long值
static Duration	between(Temporal startTimeInclude, Temporal endTimeExclude)	获取两个日期的差，如果结束时间早于开始时间，获取结果为负。
static long	between(Temporal startTimeInclude, Temporal endTimeExclude, ChronoUnit unit)	获取两个日期的差，如果结束时间早于开始时间，获取结果为负。
long	between(Units unit)	判断两个日期相差的时长 返回 给定单位的时长差
long	betweenMonth(boolean isReset)	计算两个日期相差月数 在非重置情况下，如果起始日期的天大于结束日期的天，月数要少算1（不足1个月）
long	betweenYear(boolean isReset)	计算两个日期相差年数 在非重置情况下，如果起始日期的月大于结束日期的月，年数要少算1（不足1年）
Date	getBegin()	获取开始时间
Date	getEnd()	获取结束日期
static Between	of(Date begin, Date end)	创建 在前的日期做为起始时间，在后的做为结束时间，间隔只保留绝对值正数
static Between	of(Date begin, Date end, boolean isAbs)	创建 在前的日期做为起始时间，在后的做为结束时间，间隔只保留绝对值正数
String	toString()
String	toString(Units unit, FormatPeriod.Level level)	格式化输出时间差
String	toString(FormatPeriod.Level level)	格式化输出时间差

Methods inherited from class java.lang.Object

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

Constructor Details

Between

public Between(Date begin,
 Date end)

构造 在前的日期做为起始时间，在后的做为结束时间，间隔只保留绝对值正数

Parameters:

begin - 起始时间

end - 结束时间

Between

public Between(Date begin,
 Date end,
 boolean isAbs)

构造 在前的日期做为起始时间，在后的做为结束时间

Parameters:

begin - 起始时间

end - 结束时间

isAbs - 日期间隔是否只保留绝对值正数

Method Details

of

public static Between of(Date begin,
 Date end)

创建 在前的日期做为起始时间，在后的做为结束时间，间隔只保留绝对值正数

Parameters:

begin - 起始时间

end - 结束时间

Returns:

Between

of

public static Between of(Date begin,
 Date end,
 boolean isAbs)

创建 在前的日期做为起始时间，在后的做为结束时间，间隔只保留绝对值正数

Parameters:

begin - 起始时间

end - 结束时间

isAbs - 日期间隔是否只保留绝对值正数

Returns:

Between

between

public static Duration between(Temporal startTimeInclude,
 Temporal endTimeExclude)

获取两个日期的差，如果结束时间早于开始时间，获取结果为负。 返回结果为Duration对象，通过调用toXXX方法返回相差单位

Parameters:

startTimeInclude - 开始时间（包含）

endTimeExclude - 结束时间（不包含）

Returns:

时间差 Duration对象

between

public static Duration between(LocalDateTime startTimeInclude,
 LocalDateTime endTimeExclude)

获取两个日期的差，如果结束时间早于开始时间，获取结果为负 返回结果为Duration对象，通过调用toXXX方法返回相差单位

Parameters:

startTimeInclude - 开始时间（包含）

endTimeExclude - 结束时间（不包含）

Returns:

时间差 Duration对象

See Also:

• between(Temporal, Temporal)

between

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

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

Parameters:

startTimeInclude - 开始时间（包括）

endTimeExclude - 结束时间（不包括）

unit - 时间差单位

Returns:

时间差

between

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

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

Parameters:

startTimeInclude - 开始时间（包括）

endTimeExclude - 结束时间（不包括）

unit - 时间差单位

Returns:

时间差

between

public static Period between(LocalDate startTimeInclude,
 LocalDate endTimeExclude)

获取两个日期的表象时间差，如果结束时间早于开始时间，获取结果为负。 比如2011年2月1日，和2021年8月11日，日相差了10天，月相差6月

Parameters:

startTimeInclude - 开始时间（包括）

endTimeExclude - 结束时间（不包括）

Returns:

时间差

between

public long between(Units unit)

判断两个日期相差的时长 返回 给定单位的时长差

Parameters:

unit - 相差的单位：相差 天Units.DAY、小时Units.HOUR 等

Returns:

时长差

betweenMonth

public long betweenMonth(boolean isReset)

计算两个日期相差月数 在非重置情况下，如果起始日期的天大于结束日期的天，月数要少算1（不足1个月）

Parameters:

isReset - 是否重置时间为起始时间（重置天时分秒）

Returns:

相差月数

betweenYear

public long betweenYear(boolean isReset)

计算两个日期相差年数 在非重置情况下，如果起始日期的月大于结束日期的月，年数要少算1（不足1年）

Parameters:

isReset - 是否重置时间为起始时间（重置月天时分秒）

Returns:

相差年数

getBegin

public Date getBegin()

获取开始时间

Returns:

获取开始时间

getEnd

public Date getEnd()

获取结束日期

Returns:

结束日期

toString

public String toString(Units unit,
 FormatPeriod.Level level)

格式化输出时间差

Parameters:

unit - 日期单位

level - 级别

Returns:

字符串

toString

public String toString(FormatPeriod.Level level)

格式化输出时间差

Parameters:

level - 级别

Returns:

字符串

toString

public String toString()

Overrides:

toString in class Object