模块 iofairy.falcon

程序包 com.iofairy.falcon.time

类 DateTimeRound

java.lang.Object

com.iofairy.falcon.time.DateTimeRound

class DateTimeRound
extends Object

对时间进行取整

从以下版本开始:

0.3.0

字段概要

字段

限定符和类型	字段	说明
private static List<ChronoUnit>	SUPPORTED_UNITS_FOR_ROUND	Supported units for round methods.
private static String	SUPPORTED_UNITS_FOR_ROUND_STRING
private static List<ChronoUnit>	SUPPORTED_UNITS_FOR_ROUND_TIME	Supported units for roundTime methods.
private static String	SUPPORTED_UNITS_FOR_ROUND_TIME_STRING

构造器概要

构造器

构造器	说明
DateTimeRound()

方法概要

限定符和类型	方法	说明
private static void	checkValidAmountUnit(ChronoUnit chronoUnit, int amountUnit)	根据指定的 ChronoUnit 校验 amountUnit 的值是否合法
private static int	halfUp(int value)	获取需要向上取整的最小值
private static int	halfUpDay(int daysOfMonth)	获取需要向上取整的最小天数
static LocalDateTime	round(LocalDateTime localDateTime, ChronoUnit chronoUnit, RoundingDT roundingDT)	对时间进行取整
static Calendar	round(Calendar calendar, ChronoUnit chronoUnit, RoundingDT roundingDT)	对时间进行取整
static Date	round(Date date, ChronoUnit chronoUnit, RoundingDT roundingDT)	对时间进行取整
static <T extends Temporal> T	round(T temporal, LocalDateTime localDateTime, ZoneId zoneId, ChronoUnit chronoUnit, RoundingDT roundingDT)	对时间进行取整
static LocalDateTime	roundTime(LocalDateTime localDateTime, ChronoUnit chronoUnit, int amountUnit, RoundingDT roundingDT)	对时间的 时，分，秒 进行取整。
static Calendar	roundTime(Calendar calendar, ChronoUnit chronoUnit, int amountUnit, RoundingDT roundingDT)	对时间的 时，分，秒 进行取整。
static Date	roundTime(Date date, ChronoUnit chronoUnit, int amountUnit, RoundingDT roundingDT)	对时间的 时，分，秒 进行取整。
static <T extends Temporal> T	roundTime(T temporal, LocalDateTime localDateTime, ZoneId zoneId, ChronoUnit chronoUnit, int amountUnit, RoundingDT roundingDT)	对时间进行取整

从类继承的方法 java.lang.Object

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

字段详细资料

SUPPORTED_UNITS_FOR_ROUND

private static final List<ChronoUnit> SUPPORTED_UNITS_FOR_ROUND

Supported units for round methods.

SUPPORTED_UNITS_FOR_ROUND_STRING

private static final String SUPPORTED_UNITS_FOR_ROUND_STRING

SUPPORTED_UNITS_FOR_ROUND_TIME

private static final List<ChronoUnit> SUPPORTED_UNITS_FOR_ROUND_TIME

Supported units for roundTime methods.

SUPPORTED_UNITS_FOR_ROUND_TIME_STRING

private static final String SUPPORTED_UNITS_FOR_ROUND_TIME_STRING

构造器详细资料

DateTimeRound

DateTimeRound()

方法详细资料

round

public static LocalDateTime round(LocalDateTime localDateTime,
                                  ChronoUnit chronoUnit,
                                  RoundingDT roundingDT)

对时间进行取整

参数:

localDateTime - 时间

chronoUnit - 按此时间单位作为取整后的精度

roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR

返回:

取整后的时间

从以下版本开始:

0.3.0

round

public static <T extends Temporal> T round(T temporal,
                                           LocalDateTime localDateTime,
                                           ZoneId zoneId,
                                           ChronoUnit chronoUnit,
                                           RoundingDT roundingDT)

对时间进行取整

类型参数:

T - 时间类型，若类型为 Instant，则以 TZ.DEFAULT_ZONE 时区为准，进行取整运算。

参数:

temporal - 时间

localDateTime - localDateTime

zoneId - 时区

chronoUnit - 按此时间单位作为取整后的精度

roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR

返回:

取整后的时间

从以下版本开始:

0.3.0

round

public static Date round(Date date,
                         ChronoUnit chronoUnit,
                         RoundingDT roundingDT)

对时间进行取整

参数:

date - 时间

chronoUnit - 按此时间单位作为取整后的精度

roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR

返回:

取整后的时间

从以下版本开始:

0.3.0

round

public static Calendar round(Calendar calendar,
                             ChronoUnit chronoUnit,
                             RoundingDT roundingDT)

对时间进行取整

参数:

calendar - 时间

chronoUnit - 按此时间单位作为取整后的精度

roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR

返回:

取整后的时间

从以下版本开始:

0.3.0

roundTime

public static Calendar roundTime(Calendar calendar,
                                 ChronoUnit chronoUnit,
                                 int amountUnit,
                                 RoundingDT roundingDT)

对时间的 时，分，秒 进行取整。

参数:

calendar - calendar

chronoUnit - 时间取整的精度

amountUnit - 时间步长

roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR

返回:

取整后的时间

从以下版本开始:

0.3.0

roundTime

public static Date roundTime(Date date,
                             ChronoUnit chronoUnit,
                             int amountUnit,
                             RoundingDT roundingDT)

对时间的 时，分，秒 进行取整。

参数:

date - date

chronoUnit - 时间取整的精度

amountUnit - 时间步长

roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR

返回:

取整后的时间

从以下版本开始:

0.3.0

roundTime

public static LocalDateTime roundTime(LocalDateTime localDateTime,
                                      ChronoUnit chronoUnit,
                                      int amountUnit,
                                      RoundingDT roundingDT)

对时间的 时，分，秒 进行取整。

参数:

localDateTime - localDateTime

chronoUnit - 时间取整的精度

amountUnit - 时间步长

roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR

返回:

取整后的时间

从以下版本开始:

0.3.0

roundTime

public static <T extends Temporal> T roundTime(T temporal,
                                               LocalDateTime localDateTime,
                                               ZoneId zoneId,
                                               ChronoUnit chronoUnit,
                                               int amountUnit,
                                               RoundingDT roundingDT)

对时间进行取整

类型参数:

T - 时间类型，若类型为 Instant，则以 TZ.DEFAULT_ZONE 时区为准，进行取整运算。

参数:

temporal - 时间

localDateTime - localDateTime

zoneId - 时区

chronoUnit - 按此时间单位作为取整后的精度

amountUnit - 时间步长

roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR

返回:

取整后的时间

从以下版本开始:

0.3.0

checkValidAmountUnit

private static void checkValidAmountUnit(ChronoUnit chronoUnit,
                                         int amountUnit)

根据指定的 ChronoUnit 校验 amountUnit 的值是否合法

参数:

chronoUnit - 时间单位

amountUnit - 时间步长

从以下版本开始:

0.3.0

halfUpDay

private static int halfUpDay(int daysOfMonth)

获取需要向上取整的最小天数

参数:

daysOfMonth - 当前月份的总天数

返回:

需要向上取整的最小天数

从以下版本开始:

0.3.0

halfUp

private static int halfUp(int value)

获取需要向上取整的最小值

参数:

value - 待计算的值

返回:

需要向上取整的最小值（-1，代表不支持四舍五入，则采用 向下取整）

从以下版本开始:

0.3.0