com.auxiliary.tool.date

Class TimeUtil

java.lang.Object

com.auxiliary.tool.date.TimeUtil

public class TimeUtil
extends Object

文件名：TimeUtil.java

用途： 提供对Time类进行扩展的方法

编码时间：2021年1月22日下午7:52:10

修改时间：2022年3月21日 下午5:28:28

Since:

JDK 1.8, autest 2.0.0

Version:

Ver1.0

Author:

彭宇琦

Method Summary

Modifier and Type	Method and Description
static int	compareTimes(Time time, Collection<Time> compareTimes) 该方法用于将指定的与一组时间进行比较，返回待比较时间在时间组中的位置下标
static int	compareTimes(Time time, Time... compareTimes) 该方法用于将指定的与一组时间进行比较，返回待比较时间在时间组中的位置下标
static Time	randomTime(Time startTime, Time endTime, TimeUnit timeUnit) 用于随机生成一个起始时间与结束时间范围内的一个时间
static Time	randomTime(Time time, TimeUnit timeUnit) 用于以当前时间和指定的时间为随机时间范围，生成一个随机的时间
static Duration	timeDifference(Time time, Time compareTime) 用于计算指定时间与待比较时间之间差值，并以Duration的形式对计算结果进行返回

Methods inherited from class java.lang.Object

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

Method Detail

randomTime

public static Time randomTime(Time startTime,
                              Time endTime,
                              TimeUnit timeUnit)

用于随机生成一个起始时间与结束时间范围内的一个时间

方法可通过传入的单位来限制随机产生的时间最小的变动单位，例如：

 Time startTime = Time.parse("2020-12-20 00:00:00");
 Time endTime = Time.parse("2020-12-22 00:00:00");
 
 TimeUtil.randomTime(startTime, endTime, TimeUnit.SECONDS)
 TimeUtil.randomTime(startTime, endTime, TimeUnit.DAYS)
 

则在以上代码中，第一次调用方法可能得到一个“2020-12-21 17:31:22”的时间或其他的可能，但第二次调用方法 仅得到“2020-12-20 00:00:00”或“2020-12-21 00:00:00”两种结果

注意：

1. 在生成随机时间的范围中，允许生成起始时间，但不会生成结束时间
2. 在随机时间中，不变的时间与起始时间一致。例如，最小的变动单位为“日”，则在生成的时间中，其时间的 时、分、秒的数值都与起始时间保持一致
3. 若起始时间大于结束时间，则会自动对时间进行调换；若起始时间与结束时间一致，则直接返回起始时间

Parameters:

startTime - 随机时间的起始时间

endTime - 随机时间的结束时间

timeUnit - 随机时间最小变动单位

Returns:

随机的时间

Since:

autest 2.0.0

randomTime

public static Time randomTime(Time time,
                              TimeUnit timeUnit)

用于以当前时间和指定的时间为随机时间范围，生成一个随机的时间

若当前时间大于指定的时间，则将当前时间作为结束时间进行处理； 若当前时间小于指定的时间，则将当前时间作为起始时间进行处理。 详细参数说明可参考randomTime(Time, Time, TimeUnit)

Parameters:

time - 指定的时间

timeUnit - 随机时间最小变动单位

Returns:

随机的时间

Since:

autest 2.0.0

timeDifference

public static Duration timeDifference(Time time,
                                      Time compareTime)

用于计算指定时间与待比较时间之间差值，并以Duration的形式对计算结果进行返回

Parameters:

time - 指定时间

compareTime - 待比较时间

Returns:

两时间的差值

Since:

autest 2.0.0

compareTimes

public static int compareTimes(Time time,
                               Time... compareTimes)

该方法用于将指定的与一组时间进行比较，返回待比较时间在时间组中的位置下标

下标从0开始计算，0表示待比较时间在时间组的第一位。

注意：方法不对时间组进行排序，当待比较时间为null时，则返回-1

Parameters:

time - 待比较时间

compareTimes - 时间组

Returns:

待比较时间在时间组中的位置

Since:

autest 3.2.0

compareTimes

public static int compareTimes(Time time,
                               Collection<Time> compareTimes)

该方法用于将指定的与一组时间进行比较，返回待比较时间在时间组中的位置下标

下标从0开始计算，0表示待比较时间在时间组的第一位。

注意：方法不对时间组进行排序，当待比较时间为null时，则返回-1

Parameters:

time - 待比较时间

compareTimes - 时间组

Returns:

待比较时间在时间组中的位置

Since:

autest 3.2.0