程序包 net.apexes.commons.lang

类 Dates

java.lang.Object

net.apexes.commons.lang.Dates

public final class Dates
extends Object

作者:

HeDYn

字段概要

字段

修饰符和类型	字段	说明
static final String	DATE_PATTERN
static final String	DATETIME_PATTERN
static final String	ISO8601_DATE_WITHOUT_ZONE_PATTERN
static final String	ISO8601_TIMESTAMP_WITHOUT_ZONE_PATTERN
static final String	MMDD_PATTERN
static final String	TIMESTAMP_PATTERN
static final String	YYYYMMDD_PATTERN

方法概要

修饰符和类型	方法	说明
static Date	dateStart(Date date)	返回代表指定日期的0时的对象
static int	dayCompare(Date date1, Date date2)	比较两日期，如果 date1 在 date2 之前、同一天、之后分别返回-1、0、1
static int	dayDiff(Date from, Date to)	计算两日期相差的天数（自然天数），即 to - from
static String	format(Date date, String pattern)
static boolean	isDateOverlap(Date startDate1, Date endDate1, Date startDate2, Date endDate2, boolean ignoreYearS1, boolean ignoreYearE1, boolean ignoreYearS2, boolean ignoreYearE2)	判断指定的日期段与指定的月日段是否重叠
static boolean	isSameDay(Date date1, Date date2)	判断指定的两个日期是否是同一天
static long	networkTimeMillis()	获取网络时间戳
static long	networkTimeMillis(int timeoutMs, String... urls)	从指定的网络地址获取网络时间戳
static long	networkTimeMillis(String... urls)	从指定的网络地址获取网络时间戳
static long	networkTimeMillis(ExecutorService executorService, int timeoutMs, String... urls)	从指定的网络地址获取网络时间戳
static long	networkTimeMillis(ExecutorService executorService, String... urls)	从指定的网络地址获取网络时间戳
static Date	parse(String date, String pattern)
static Date	parseAdaptive(String dateStr)
static Date	yearStart(Date date)	获取指定日期所在年份的第一天

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

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

字段详细资料

DATE_PATTERN

public static final String DATE_PATTERN

另请参阅:

• 常量字段值

DATETIME_PATTERN

public static final String DATETIME_PATTERN

另请参阅:

• 常量字段值

TIMESTAMP_PATTERN

public static final String TIMESTAMP_PATTERN

另请参阅:

• 常量字段值

ISO8601_DATE_WITHOUT_ZONE_PATTERN

public static final String ISO8601_DATE_WITHOUT_ZONE_PATTERN

另请参阅:

• 常量字段值

ISO8601_TIMESTAMP_WITHOUT_ZONE_PATTERN

public static final String ISO8601_TIMESTAMP_WITHOUT_ZONE_PATTERN

另请参阅:

• 常量字段值

YYYYMMDD_PATTERN

public static final String YYYYMMDD_PATTERN

另请参阅:

• 常量字段值

MMDD_PATTERN

public static final String MMDD_PATTERN

另请参阅:

• 常量字段值

方法详细资料

networkTimeMillis

public static long networkTimeMillis()
                              throws Exception

获取网络时间戳

返回:

返回网络时间戳

抛出:

Exception - 获取网络时间失败时抛出

networkTimeMillis

public static long networkTimeMillis(String... urls)
                              throws Exception

从指定的网络地址获取网络时间戳

参数:

urls - 网址

返回:

返回网络时间戳

抛出:

Exception - 获取网络时间失败时抛出

networkTimeMillis

public static long networkTimeMillis(ExecutorService executorService,
 String... urls)
                              throws Exception

从指定的网络地址获取网络时间戳

参数:

executorService - 执行获取时间任务的线程池

urls - 网址

返回:

返回网络时间戳

抛出:

Exception - 获取网络时间失败时抛出

networkTimeMillis

public static long networkTimeMillis(int timeoutMs,
 String... urls)
                              throws Exception

从指定的网络地址获取网络时间戳

参数:

timeoutMs - 超时时间，单位ms

urls - 网址

返回:

返回网络时间戳

抛出:

Exception - 获取网络时间失败时抛出

networkTimeMillis

public static long networkTimeMillis(ExecutorService executorService,
 int timeoutMs,
 String... urls)
                              throws Exception

从指定的网络地址获取网络时间戳

参数:

executorService - 执行获取时间任务的线程池

timeoutMs - 超时时间，单位ms

urls - 网址

返回:

返回网络时间戳

抛出:

Exception - 获取网络时间失败时抛出

yearStart

public static Date yearStart(Date date)

获取指定日期所在年份的第一天

参数:

date -

返回:

dateStart

public static Date dateStart(Date date)

返回代表指定日期的0时的对象

参数:

date -

返回:

返回代表指定日期的0时的对象

dayDiff

public static int dayDiff(Date from,
 Date to)

计算两日期相差的天数（自然天数），即 to - from

参数:

from - 开始日期

to - 结束日期

返回:

返回相差的天数，即结束日期减开始日期得到的自然天数

dayCompare

public static int dayCompare(Date date1,
 Date date2)

比较两日期，如果 date1 在 date2 之前、同一天、之后分别返回-1、0、1

参数:

date1 -

date2 -

返回:

如果 date1 在 date2 之前、同一天、之后分别返回-1、0、1

isSameDay

public static boolean isSameDay(Date date1,
 Date date2)

判断指定的两个日期是否是同一天

参数:

date1 -

date2 -

返回:

如果是同一天返回true，否则返回false

isDateOverlap

public static boolean isDateOverlap(Date startDate1,
 Date endDate1,
 Date startDate2,
 Date endDate2,
 boolean ignoreYearS1,
 boolean ignoreYearE1,
 boolean ignoreYearS2,
 boolean ignoreYearE2)

判断指定的日期段与指定的月日段是否重叠

参数:

startDate1 -

endDate1 -

startDate2 -

endDate2 -

ignoreYearS1 - 忽略startDate1中的年份

ignoreYearE1 - 忽略endDate1中的年份

ignoreYearS2 - 忽略startDate2中的年份

ignoreYearE2 - 忽略endDate2中的年份

返回:

重叠返回true，否则返回false

format

public static String format(Date date,
 String pattern)

parse

public static Date parse(String date,
 String pattern)
                  throws ParseException

抛出:

ParseException

parseAdaptive

public static Date parseAdaptive(String dateStr)
                          throws ParseException

抛出:

ParseException