模块 iofairy.falcon

程序包 com.iofairy.falcon.time

类 DateTimeShift

java.lang.Object

com.iofairy.falcon.time.DateTimeShift

class DateTimeShift
extends Object

偏移时间，并记录每次偏移后的时间

从以下版本开始:

0.3.0

字段概要

字段

限定符和类型	字段	说明
private static List<ChronoUnit>	SUPPORTED_UNITS_FOR_DBS	Supported units for datesByShift and datesFromRange methods.
private static String	SUPPORTED_UNITS_FOR_DBS_STRING

构造器概要

构造器

构造器	说明
DateTimeShift()

方法概要

限定符和类型	方法	说明
private static void	addAmountToCalendar(Calendar calendar, int amountUnit, ChronoUnit chronoUnit)	Adds or subtracts the specified amount of time to the given calendar field, based on the calendar's rules.
static List<Calendar>	datesByShift(Calendar fromCalendar, int shiftTimes, int amountUnit, ChronoUnit chronoUnit, boolean includeCurrentTime)	从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
static List<Date>	datesByShift(Date fromDate, ZonedDateTime zdt, int shiftTimes, int amountUnit, ChronoUnit chronoUnit, boolean includeCurrentTime)	从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
static <T extends Temporal> List<T>	datesByShift(T fromTemporal, int shiftTimes, int amountUnit, ChronoUnit chronoUnit, boolean includeCurrentTime)	从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
static List<Calendar>	datesFromRange(Calendar fromCalendar, Calendar toCalendar, int amountUnit, ChronoUnit chronoUnit, IntervalType intervalType)	从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
static List<Date>	datesFromRange(Date fromDate, Date toDate, ZonedDateTime fromZdt, ZonedDateTime toZdt, int amountUnit, ChronoUnit chronoUnit, IntervalType intervalType)	从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
static <T extends Temporal> List<T>	datesFromRange(T fromTemporal, Temporal toTemporal, int amountUnit, ChronoUnit chronoUnit, IntervalType intervalType)	从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
private static long	getShiftTimes(ChronoUnit chronoUnit, SignedInterval signedInterval)

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

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

字段详细资料

SUPPORTED_UNITS_FOR_DBS

private static final List<ChronoUnit> SUPPORTED_UNITS_FOR_DBS

Supported units for datesByShift and datesFromRange methods.

SUPPORTED_UNITS_FOR_DBS_STRING

private static final String SUPPORTED_UNITS_FOR_DBS_STRING

构造器详细资料

DateTimeShift

DateTimeShift()

方法详细资料

datesByShift

public static List<Date> datesByShift(Date fromDate,
                                      ZonedDateTime zdt,
                                      int shiftTimes,
                                      int amountUnit,
                                      ChronoUnit chronoUnit,
                                      boolean includeCurrentTime)

从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表

参数:

fromDate - 开始的时间

zdt - 时间对应的 ZonedDateTime

shiftTimes - 偏移的次数，负数：则时间往前偏移；正数：则时间往后偏移

amountUnit - 偏移的步长

chronoUnit - 时间单位

includeCurrentTime - 最后列表是否包含 fromDate

返回:

每次偏移后的所有时间列表

从以下版本开始:

0.3.0

datesByShift

public static List<Calendar> datesByShift(Calendar fromCalendar,
                                          int shiftTimes,
                                          int amountUnit,
                                          ChronoUnit chronoUnit,
                                          boolean includeCurrentTime)

从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表

参数:

fromCalendar - 开始的时间

shiftTimes - 偏移的次数，负数：则时间往前偏移；正数：则时间往后偏移

amountUnit - 偏移的步长

chronoUnit - 时间单位

includeCurrentTime - 最后列表是否包含 fromCalendar

返回:

每次偏移后的所有时间列表

从以下版本开始:

0.3.0

datesByShift

public static <T extends Temporal> List<T> datesByShift(T fromTemporal,
                                                        int shiftTimes,
                                                        int amountUnit,
                                                        ChronoUnit chronoUnit,
                                                        boolean includeCurrentTime)

从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表

类型参数:

T - fromTemporal的类型

参数:

fromTemporal - 开始的时间。如果 fromTemporal 的类型是 Instant 时，会转成 DateTimes.defaultOffset() 时区的 OffsetDateTime 对象，再进行计算。

shiftTimes - 偏移的次数，负数：则时间往前偏移；正数：则时间往后偏移

amountUnit - 偏移的步长

chronoUnit - 时间单位

includeCurrentTime - 最后列表是否包含 fromTemporal

返回:

每次偏移后的所有时间列表

从以下版本开始:

0.3.0

datesFromRange

public static List<Date> datesFromRange(Date fromDate,
                                        Date toDate,
                                        ZonedDateTime fromZdt,
                                        ZonedDateTime toZdt,
                                        int amountUnit,
                                        ChronoUnit chronoUnit,
                                        IntervalType intervalType)

从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表

参数:

fromDate - 开始的时间

toDate - 结束的时间

fromZdt - 开始时间对应的 ZonedDateTime

toZdt - 结束时间对应的 ZonedDateTime

amountUnit - 偏移的步长

chronoUnit - 时间单位

intervalType - 区间类型

返回:

每次偏移后的所有时间列表

从以下版本开始:

0.3.0

datesFromRange

public static List<Calendar> datesFromRange(Calendar fromCalendar,
                                            Calendar toCalendar,
                                            int amountUnit,
                                            ChronoUnit chronoUnit,
                                            IntervalType intervalType)

从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表

参数:

fromCalendar - 开始的时间

toCalendar - 结束的时间

amountUnit - 偏移的步长

chronoUnit - 时间单位

intervalType - 区间类型

返回:

每次偏移后的所有时间列表

从以下版本开始:

0.3.0

datesFromRange

public static <T extends Temporal> List<T> datesFromRange(T fromTemporal,
                                                          Temporal toTemporal,
                                                          int amountUnit,
                                                          ChronoUnit chronoUnit,
                                                          IntervalType intervalType)

从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表

类型参数:

T - fromTemporal的类型

参数:

fromTemporal - 开始的时间。如果 fromTemporal 的类型是 Instant 时，会转成 DateTimes.defaultOffset() 时区的 OffsetDateTime 对象，再进行计算。

toTemporal - 结束的时间

amountUnit - 偏移的步长

chronoUnit - 时间单位

intervalType - 区间类型

返回:

每次偏移后的所有时间列表

从以下版本开始:

0.3.0

addAmountToCalendar

private static void addAmountToCalendar(Calendar calendar,
                                        int amountUnit,
                                        ChronoUnit chronoUnit)

Adds or subtracts the specified amount of time to the given calendar field, based on the calendar's rules.

参数:

calendar - calendar

amountUnit - amount

chronoUnit - chronoUnit

从以下版本开始:

0.3.0

getShiftTimes

private static long getShiftTimes(ChronoUnit chronoUnit,
                                  SignedInterval signedInterval)