org.dromara.hutool.core.date

Class BetweenFormatter

java.lang.Object

org.dromara.hutool.core.date.BetweenFormatter

All Implemented Interfaces:

Serializable

public class BetweenFormatter
extends Object
implements Serializable

时长格式化器，用于格式化输出两个日期相差的时长
根据BetweenFormatter.Level不同，调用format()方法后返回类似于：

• XX小时XX分XX秒
• XX天XX小时
• XX月XX天XX小时

Author:

Looly

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BetweenFormatter.Level 格式化等级枚举

Constructor Summary

Constructors

Constructor and Description
BetweenFormatter(long betweenMs, BetweenFormatter.Level level, int levelMaxCount) 构造

Method Summary

Modifier and Type	Method and Description
String	format() 格式化日期间隔输出
long	getBetweenMs() 获得 时长毫秒数
BetweenFormatter.Level	getLevel() 获得 格式化级别
static BetweenFormatter	of(long betweenMs, BetweenFormatter.Level level) 创建 BetweenFormatter
static BetweenFormatter	of(long betweenMs, BetweenFormatter.Level level, int levelMaxCount) 创建 BetweenFormatter
BetweenFormatter	setBetweenMs(long betweenMs) 设置 时长毫秒数
BetweenFormatter	setLevel(BetweenFormatter.Level level) 设置格式化级别
BetweenFormatter	setLevelFormatter(Function<BetweenFormatter.Level,String> levelFormatter) 设置级别格式化器
BetweenFormatter	setSeparator(String separator) 设置分隔符
BetweenFormatter	setSimpleMode(boolean simpleMode) 是否为简化模式，此标记用于自定义是否输出各个位数中间为0的部分 如为true，输出 1小时3秒，为false输出 1小时0分3秒
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

BetweenFormatter

public BetweenFormatter(long betweenMs,
                        BetweenFormatter.Level level,
                        int levelMaxCount)

构造

Parameters:

betweenMs - 日期间隔

level - 级别，按照天、小时、分、秒、毫秒分为5个等级，根据传入等级，格式化到相应级别

levelMaxCount - 格式化级别的最大个数，假如级别个数为1，但是级别到秒，那只显示一个级别

Method Detail

of

public static BetweenFormatter of(long betweenMs,
                                  BetweenFormatter.Level level)

创建 BetweenFormatter

Parameters:

betweenMs - 日期间隔

level - 级别，按照天、小时、分、秒、毫秒分为5个等级，根据传入等级，格式化到相应级别

Returns:

BetweenFormatter

of

public static BetweenFormatter of(long betweenMs,
                                  BetweenFormatter.Level level,
                                  int levelMaxCount)

创建 BetweenFormatter

Parameters:

betweenMs - 日期间隔

level - 级别，按照天、小时、分、秒、毫秒分为5个等级，根据传入等级，格式化到相应级别

levelMaxCount - 格式化级别的最大个数，假如级别个数为1，但是级别到秒，那只显示一个级别

Returns:

BetweenFormatter

format

public String format()

格式化日期间隔输出

Returns:

格式化后的字符串

getBetweenMs

public long getBetweenMs()

获得 时长毫秒数

Returns:

时长毫秒数

setBetweenMs

public BetweenFormatter setBetweenMs(long betweenMs)

设置 时长毫秒数

Parameters:

betweenMs - 时长毫秒数

Returns:

this

getLevel

public BetweenFormatter.Level getLevel()

获得 格式化级别

Returns:

格式化级别

setLevel

public BetweenFormatter setLevel(BetweenFormatter.Level level)

设置格式化级别

Parameters:

level - 格式化级别

Returns:

this

setSimpleMode

public BetweenFormatter setSimpleMode(boolean simpleMode)

是否为简化模式，此标记用于自定义是否输出各个位数中间为0的部分
如为true，输出 1小时3秒，为false输出 1小时0分3秒

Parameters:

simpleMode - 是否简化模式

Returns:

this

setLevelFormatter

public BetweenFormatter setLevelFormatter(Function<BetweenFormatter.Level,String> levelFormatter)

设置级别格式化器

Parameters:

levelFormatter - 级别格式化器

Returns:

this

setSeparator

public BetweenFormatter setSeparator(String separator)

设置分隔符

Parameters:

separator - 分割符

Returns:

this

toString

public String toString()

Overrides:

toString in class Object