cn.hutool.core.date

Class DateBetween

java.lang.Object

cn.hutool.core.date.DateBetween

All Implemented Interfaces:

Serializable

public class DateBetween
extends Object
implements Serializable

日期间隔

Author:

Looly

See Also:

Serialized Form

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
long	between(DateUnit unit) 判断两个日期相差的时长 返回 给定单位的时长差
long	betweenMonth(boolean isReset) 计算两个日期相差月数 在非重置情况下，如果起始日期的天大于结束日期的天，月数要少算1（不足1个月）
long	betweenYear(boolean isReset) 计算两个日期相差年数 在非重置情况下，如果起始日期的月大于结束日期的月，年数要少算1（不足1年）
static DateBetween	create(Date begin, Date end) 创建 在前的日期做为起始时间，在后的做为结束时间，间隔只保留绝对值正数
static DateBetween	create(Date begin, Date end, boolean isAbs) 创建 在前的日期做为起始时间，在后的做为结束时间，间隔只保留绝对值正数
String	toString()
String	toString(BetweenFormatter.Level level) 格式化输出时间差
String	toString(DateUnit unit, BetweenFormatter.Level level) 格式化输出时间差

Methods inherited from class java.lang.Object

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

Constructor Detail

DateBetween

public DateBetween(Date begin,
                   Date end)

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

Parameters:

begin - 起始时间

end - 结束时间

DateBetween

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

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

Parameters:

begin - 起始时间

end - 结束时间

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

Since:

3.1.1

Method Detail

create

public static DateBetween create(Date begin,
                                 Date end)

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

Parameters:

begin - 起始时间

end - 结束时间

Returns:

DateBetween

Since:

3.2.3

create

public static DateBetween create(Date begin,
                                 Date end,
                                 boolean isAbs)

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

Parameters:

begin - 起始时间

end - 结束时间

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

Returns:

DateBetween

Since:

3.2.3

between

public long between(DateUnit unit)

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

Parameters:

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

Returns:

时长差

betweenMonth

public long betweenMonth(boolean isReset)

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

Parameters:

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

Returns:

相差月数

Since:

3.0.8

betweenYear

public long betweenYear(boolean isReset)

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

Parameters:

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

Returns:

相差年数

Since:

3.0.8

toString

public String toString(DateUnit unit,
                       BetweenFormatter.Level level)

格式化输出时间差

Parameters:

unit - 日期单位

level - 级别

Returns:

字符串

Since:

5.7.17

toString

public String toString(BetweenFormatter.Level level)

格式化输出时间差

Parameters:

level - 级别

Returns:

字符串

toString

public String toString()

Overrides:

toString in class Object