top.zhogjianhao

类 DateUtils

java.lang.Object

org.apache.commons.lang3.time.DateUtils

top.zhogjianhao.DateUtils

public class DateUtils
extends org.apache.commons.lang3.time.DateUtils

时间工具类

作者:

duanluan

字段概要

字段

限定符和类型	字段和说明
static ResolverStyle	DEFAULT_RESOLVER_STYLE 默认解析模式：严格模式（https://rumenz.com/java-topic/java/date-time/resolverstyle-strict-date-parsing/index.html）
static String	defaultDatePattern Date 默认格式
static String	defaultLocalDatePattern LocalDate 默认格式
static String	defaultLocalDateTimePattern LocalDateTime 默认格式
static String	defaultLocalTimePattern LocalTime 默认格式
static int	MIN_YEAR 最小年份：java.time.temporal.ChronoField#EPOCH_DAY
static String	PATTERN_HH_MM
static String	PATTERN_HH_MM_SS
static String	PATTERN_MM_DD
static String	PATTERN_MM_DD_HH_MM
static String	PATTERN_MM_DD_HH_MM_SS
static String	PATTERN_MMDDHHMMSS
static String	PATTERN_UUUU_MM
static String	PATTERN_UUUU_MM_DD
static String	PATTERN_UUUU_MM_DD_HH_MM
static String	PATTERN_UUUU_MM_DD_HH_MM_SS
static String	PATTERN_UUUUMMDDHHMMSS
static String	PATTERN_YYYY_MM
static String	PATTERN_YYYY_MM_DD
static String	PATTERN_YYYY_MM_DD_HH_MM
static String	PATTERN_YYYY_MM_DD_HH_MM_SS
static String	PATTERN_YYYYMMDDHHMMSS
static ZoneId	SYSTEM_ZONE_ID 系统时区
static ZoneOffset	SYSTEM_ZONE_OFFSET 系统时区偏移

从类继承的字段 org.apache.commons.lang3.time.DateUtils

MILLIS_PER_DAY, MILLIS_PER_HOUR, MILLIS_PER_MINUTE, MILLIS_PER_SECOND, RANGE_MONTH_MONDAY, RANGE_MONTH_SUNDAY, RANGE_WEEK_CENTER, RANGE_WEEK_MONDAY, RANGE_WEEK_RELATIVE, RANGE_WEEK_SUNDAY, SEMI_MONTH

构造器概要

构造器

构造器和说明
DateUtils()

方法概要

限定符和类型	方法和说明
static String[]	convertWeeks(@NonNull String weeks) 转换星期字符串为星期数组
static String[]	convertWeeks(@NonNull String weeks, @NonNull String splitRegex) 转换星期字符串为星期数组
static String	format(@NonNull Date date) 格式化为 DateUtils#defaultDatePattern 的字符串
static String	format(@NonNull Date date, @NonNull String pattern) 格式化为指定格式的字符串
static String	format(@NonNull Date date, @NonNull ZoneId zoneId) 格式化为指定时区的字符串
static String	format(@NonNull Date date, ZoneId zoneId, @NonNull String pattern) 格式化为指定时区和格式的字符串
static String	format(@NonNull Temporal temporal) 格式化为指定格式的字符串，格式根据时间对象的类型判断 LocalDateTime、ZonedDateTime：DateUtils#defaultLocalDatePattern LocalDate：DateUtils#defaultLocalDateTimePattern LocalTime：DateUtils#defaultLocalTimePattern
static String	format(@NonNull Temporal temporal, @NonNull String pattern) 格式化为指定格式的字符串
static String	format(@NonNull Temporal temporal, ZoneId zoneId) 格式化为指定时区和格式的字符串，格式根据时间对象的类型判断 LocalDateTime、ZonedDateTime：DateUtils#defaultLocalDatePattern LocalDate：DateUtils#defaultLocalDateTimePattern LocalTime：DateUtils#defaultLocalTimePattern
static String	format(@NonNull Temporal temporal, ZoneId zoneId, @NonNull String pattern) 格式化为指定时区和格式的字符串
static List<String>	getByRange(@NonNull LocalDateTime startTime, @NonNull LocalDateTime endTime, @NonNull String pattern) 获取日期范围内的所有日期
static List<LocalDateTime>	getByRangeAndWeeks(@NonNull LocalDateTime startTime, @NonNull LocalDateTime endTime, @NonNull String weeks) 获取日期范围内的所有指定星期，包含开始日期和结束日期
static List<String>	getByRangeAndWeeks(@NonNull LocalDateTime startTime, @NonNull LocalDateTime endTime, @NonNull String weeks, @NonNull String pattern) 获取日期范围内的所有指定星期，包含开始日期和结束日期
static List<LocalDateTime>	getByWeeks(@NonNull String weeks, LocalDateTime... times) 获取符合周几的时间
static DateTimeFormatter	getDefaultFormatter(@NonNull String pattern) 获取默认的时间格式器（严格模式），对应时间级别没有就赋默认值：1970-01-01 00:00:00.0，内容格式为英文
static DateTimeFormatter	getDefaultFormatter(@NonNull String pattern, @NonNull Locale locale) 获取默认的时间格式器（严格模式），对应时间级别没有就赋默认值：1970-01-01 00:00:00.0
static DateTimeFormatter	getDefaultFormatter(@NonNull String pattern, Locale locale, ZoneId atZoneId) 获取默认的时间格式器（严格模式），对应时间级别没有就赋默认值：1970-01-01 00:00:00.00000000
static DateTimeFormatter	getDefaultFormatter(@NonNull String pattern, @NonNull ZoneId atZoneId) 获取默认的时间格式器（严格模式），对应时间级别没有就赋默认值：1970-01-01 00:00:00.0
static List<LocalDateTime[]>	getDifferenceSetsByIntersectional(@NonNull LocalDateTime x1, @NonNull LocalDateTime y1, @NonNull LocalDateTime x2, @NonNull LocalDateTime y2) 获取两个时间段交集时差集的时间段
static DateTimeFormatterBuilder	getFormatterBuilder(@NonNull String pattern, Map<TemporalField,Long> fieldValueMap) 获取时间格式化构造器，并给不同时间级别赋默认值
static LocalDateTime[]	getIntersection(@NonNull LocalDateTime x1, @NonNull LocalDateTime y1, @NonNull LocalDateTime x2, @NonNull LocalDateTime y2) 获取两个时间段的交集
static boolean	isIntersection(@NonNull LocalDateTime x1, @NonNull LocalDateTime y1, @NonNull LocalDateTime x2, @NonNull LocalDateTime y2) 两个时间段是否交集
static String	now() 获取当前时间字符串
static String	now(@NonNull String pattern) 获取指定格式的当前时间字符串
static String	now(@NonNull ZoneId zoneId) 获取指定时区的当前时间字符串
static String	now(@NonNull ZoneId zoneId, @NonNull String pattern) 获取指定时区和格式的当前时间字符串
static <T> T	parse(@NonNull long timeStamp, @NonNull Class<T> clazz) 解析为时间对象
static <T> T	parse(@NonNull long timeStamp, ZoneId zoneId, @NonNull Class<T> clazz) 解析为指定时区的时间对象
static <T> T	parse(@NonNull String source, @NonNull Class<T> clazz) 解析为时间对象
static <T> T	parse(@NonNull String source, @NonNull Class<T> clazz, String... patterns) 满足任意格式时解析为时间对象
static <T> T	parse(@NonNull String source, @NonNull ZoneId zoneId, @NonNull Class<T> clazz) 解析指定时区的时间对象
static <T> T	parse(@NonNull String source, ZoneId zoneId, @NonNull Class<T> clazz, String... patterns) 满足任意格式时解析为指定时区的时间对象
static Date	parseDate(@NonNull long timeStamp) 解析为 Date 对象
static Date	parseDate(@NonNull long timeStamp, ZoneId zoneId) 解析为指定时区的 Date 对象
static Date	parseDate(@NonNull String source) 解析为 Date 对象
static Date	parseDate(@NonNull String source, String... patterns) 满足任意格式时解析为 Date 对象（org.apache.commons.lang3.time.DateUtils.parseDate）
static Date	parseDate(@NonNull String source, @NonNull ZoneId zoneId) 解析为指定时区的 Date 对象
static Date	parseDate(@NonNull String source, ZoneId zoneId, String... patterns) 满足任意格式时解析为指定时区的 Date 对象
static LocalDate	parseLocalDate(@NonNull long timeStamp) 解析为 LocalDate 对象
static LocalDate	parseLocalDate(@NonNull long timeStamp, ZoneId zoneId) 解析为指定时区的 LocalDate 对象
static LocalDate	parseLocalDate(@NonNull String source) 解析为 LocalDate 对象，根据被解析字符串的长度判断格式 10：DateUtils#PATTERN_UUUU_MM_DD 7：DateUtils#PATTERN_UUUU_MM 8：DateUtils#PATTERN_HH_MM_SS 5：DateUtils#PATTERN_HH_MM
static LocalDate	parseLocalDate(@NonNull String source, String... pattern) 满足任意格式就解析为 LocalDate 对象
static LocalDate	parseLocalDate(@NonNull String source, ZoneId zoneId) 解析为指定时区的 LocalDate 对象，根据被解析字符串的长度判断格式 需要注意的是 LocalDate 不存在时区概念，此处是将 time 补足为 LocalTime.MIN 后再转换为 LocalDate 10：DateUtils#PATTERN_UUUU_MM_DD 7：DateUtils#PATTERN_UUUU_MM 8：DateUtils#PATTERN_HH_MM_SS 5：DateUtils#PATTERN_HH_MM
static LocalDate	parseLocalDate(@NonNull String source, ZoneId zoneId, String... patterns) 满足任意格式时解析为指定时区的 LocalDate 对象 需要注意的是 LocalDate 不存在时区概念，此处是将 time 补足为 LocalTime.MIN 后再转换为 LocalDate
static LocalDateTime	parseLocalDateTime(@NonNull long timeStamp) 解析为 LocalDateTime 对象
static LocalDateTime	parseLocalDateTime(@NonNull long timeStamp, ZoneId zoneId) 解析为指定时区的 LocalDateTime 对象
static LocalDateTime	parseLocalDateTime(@NonNull String source) 解析为 LocalDateTime 对象，根据被解析字符串的长度判断格式 19：DateUtils#PATTERN_UUUU_MM_DD_HH_MM_SS 16：DateUtils#PATTERN_UUUU_MM_DD_HH_MM 10：DateUtils#PATTERN_UUUU_MM_DD 7：DateUtils#PATTERN_UUUU_MM 8：DateUtils#PATTERN_HH_MM_SS 5：DateUtils#PATTERN_HH_MM
static LocalDateTime	parseLocalDateTime(@NonNull String source, String... patterns) 满足任意格式时解析为 LocalDateTime 对象
static LocalDateTime	parseLocalDateTime(@NonNull String source, ZoneId zoneId) 解析为指定时区的 LocalDateTime 对象，根据被解析字符串的长度判断格式 19：DateUtils#PATTERN_UUUU_MM_DD_HH_MM_SS 16：DateUtils#PATTERN_UUUU_MM_DD_HH_MM 10：DateUtils#PATTERN_UUUU_MM_DD 7：DateUtils#PATTERN_UUUU_MM 8：DateUtils#PATTERN_HH_MM_SS 5：DateUtils#PATTERN_HH_MM
static LocalDateTime	parseLocalDateTime(@NonNull String source, ZoneId zoneId, String... patterns) 满足任意格式时解析为指定时区的 LocalDateTime 对象
static LocalTime	parseLocalTime(@NonNull long timeStamp) 解析为 LocalTime 对象
static LocalTime	parseLocalTime(@NonNull long timeStamp, ZoneId zoneId) 解析为指定时区的 LocalTime 对象
static LocalTime	parseLocalTime(@NonNull String source) 解析为 LocalTime，根据被解析字符串的长度判断格式 8：DateUtils#PATTERN_HH_MM_SS 5：DateUtils#PATTERN_HH_MM
static LocalTime	parseLocalTime(@NonNull String source, String... patterns) 满足任意格式就解析为 LocalTime 对象
static LocalTime	parseLocalTime(@NonNull String source, ZoneId zoneId) 解析为指定时区的 LocalTime 对象，根据被解析字符串的长度判断格式 需要注意的是 LocalTime 不存在时区概念，此处是将 date 补足为 LocalDate.now() 后再转换为 LocalTime 8：DateUtils#PATTERN_HH_MM_SS 5：DateUtils#PATTERN_HH_MM
static LocalTime	parseLocalTime(@NonNull String source, ZoneId zoneId, String... patterns) 满足任意格式时解析为指定时区的 LocalTime 对象 需要注意的是 LocalTime 不存在时区概念，此处是将 date 补足为 LocalDate.now() 后再转换为 LocalTime
static <T extends Temporal> T	plusOrMinus(T temporal, @NonNull long augendOrMinuend, ChronoUnit chronoUnit) 获取减去或加上指定类型数量的时间
static Date	toDate(@NonNull Temporal temporal) 转换为 Date 对象
static Date	toDate(@NonNull Temporal temporal, ZoneId zoneId) 转换为指定时区的 Date 对象
static Date	withZoneInstant(@NonNull Date date, @NonNull ZoneId newZoneId) 从系统时区转换到新时区
static Date	withZoneInstant(@NonNull Date date, @NonNull ZoneId oldZoneId, @NonNull ZoneId newZoneId) 从旧时区转换到新时区
static <T extends Temporal> T	withZoneInstant(T temporal, @NonNull ZoneId newZoneId) 从系统时区转换到新时区
static <T extends Temporal> T	withZoneInstant(T temporal, @NonNull ZoneId oldZoneId, @NonNull ZoneId newZoneId) 从旧时区转换到新时区 ZonedDateTime 对象请直接用 .withZoneSameInstant(newZoneId)

从类继承的方法 org.apache.commons.lang3.time.DateUtils

addDays, addHours, addMilliseconds, addMinutes, addMonths, addSeconds, addWeeks, addYears, ceiling, ceiling, ceiling, getFragmentInDays, getFragmentInDays, getFragmentInHours, getFragmentInHours, getFragmentInMilliseconds, getFragmentInMilliseconds, getFragmentInMinutes, getFragmentInMinutes, getFragmentInSeconds, getFragmentInSeconds, isSameDay, isSameDay, isSameInstant, isSameInstant, isSameLocalTime, iterator, iterator, iterator, parseDate, parseDateStrictly, parseDateStrictly, round, round, round, setDays, setHours, setMilliseconds, setMinutes, setMonths, setSeconds, setYears, toCalendar, toCalendar, truncate, truncate, truncate, truncatedCompareTo, truncatedCompareTo, truncatedEquals, truncatedEquals

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

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

字段详细资料

PATTERN_UUUU_MM_DD_HH_MM_SS

public static final String PATTERN_UUUU_MM_DD_HH_MM_SS

另请参阅:

常量字段值

PATTERN_UUUUMMDDHHMMSS

public static final String PATTERN_UUUUMMDDHHMMSS

另请参阅:

常量字段值

PATTERN_UUUU_MM_DD_HH_MM

public static final String PATTERN_UUUU_MM_DD_HH_MM

另请参阅:

常量字段值

PATTERN_UUUU_MM_DD

public static final String PATTERN_UUUU_MM_DD

另请参阅:

常量字段值

PATTERN_UUUU_MM

public static final String PATTERN_UUUU_MM

另请参阅:

常量字段值

PATTERN_YYYY_MM_DD_HH_MM_SS

public static final String PATTERN_YYYY_MM_DD_HH_MM_SS

另请参阅:

常量字段值

PATTERN_YYYYMMDDHHMMSS

public static final String PATTERN_YYYYMMDDHHMMSS

另请参阅:

常量字段值

PATTERN_YYYY_MM_DD_HH_MM

public static final String PATTERN_YYYY_MM_DD_HH_MM

另请参阅:

常量字段值

PATTERN_YYYY_MM_DD

public static final String PATTERN_YYYY_MM_DD

另请参阅:

常量字段值

PATTERN_YYYY_MM

public static final String PATTERN_YYYY_MM

另请参阅:

常量字段值

PATTERN_MM_DD_HH_MM_SS

public static final String PATTERN_MM_DD_HH_MM_SS

另请参阅:

常量字段值

PATTERN_MMDDHHMMSS

public static final String PATTERN_MMDDHHMMSS

另请参阅:

常量字段值

PATTERN_MM_DD_HH_MM

public static final String PATTERN_MM_DD_HH_MM

另请参阅:

常量字段值

PATTERN_MM_DD

public static final String PATTERN_MM_DD

另请参阅:

常量字段值

PATTERN_HH_MM_SS

public static final String PATTERN_HH_MM_SS

另请参阅:

常量字段值

PATTERN_HH_MM

public static final String PATTERN_HH_MM

另请参阅:

常量字段值

MIN_YEAR

public static final int MIN_YEAR

最小年份：java.time.temporal.ChronoField#EPOCH_DAY

另请参阅:

常量字段值

SYSTEM_ZONE_ID

public static final ZoneId SYSTEM_ZONE_ID

系统时区

SYSTEM_ZONE_OFFSET

public static final ZoneOffset SYSTEM_ZONE_OFFSET

系统时区偏移

DEFAULT_RESOLVER_STYLE

public static final ResolverStyle DEFAULT_RESOLVER_STYLE

默认解析模式：严格模式（https://rumenz.com/java-topic/java/date-time/resolverstyle-strict-date-parsing/index.html）

defaultDatePattern

public static String defaultDatePattern

Date 默认格式

defaultLocalDatePattern

public static String defaultLocalDatePattern

LocalDate 默认格式

defaultLocalDateTimePattern

public static String defaultLocalDateTimePattern

LocalDateTime 默认格式

defaultLocalTimePattern

public static String defaultLocalTimePattern

LocalTime 默认格式

构造器详细资料

DateUtils

public DateUtils()

方法详细资料

getFormatterBuilder

public static DateTimeFormatterBuilder getFormatterBuilder(@NonNull
                                                           @NonNull String pattern,
                                                           Map<TemporalField,Long> fieldValueMap)

获取时间格式化构造器，并给不同时间级别赋默认值

参数:

pattern - 格式

fieldValueMap - 时间类型和值

返回:

时间格式构造器

getDefaultFormatter

public static DateTimeFormatter getDefaultFormatter(@NonNull
                                                    @NonNull String pattern,
                                                    Locale locale,
                                                    ZoneId atZoneId)

获取默认的时间格式器（严格模式），对应时间级别没有就赋默认值：1970-01-01 00:00:00.00000000

参数:

pattern - 格式

locale - 区域

atZoneId - 时区

返回:

时间格式器

getDefaultFormatter

public static DateTimeFormatter getDefaultFormatter(@NonNull
                                                    @NonNull String pattern,
                                                    @NonNull
                                                    @NonNull Locale locale)

获取默认的时间格式器（严格模式），对应时间级别没有就赋默认值：1970-01-01 00:00:00.0

参数:

pattern - 格式

locale - 区域

返回:

时间格式器

getDefaultFormatter

public static DateTimeFormatter getDefaultFormatter(@NonNull
                                                    @NonNull String pattern,
                                                    @NonNull
                                                    @NonNull ZoneId atZoneId)

获取默认的时间格式器（严格模式），对应时间级别没有就赋默认值：1970-01-01 00:00:00.0

参数:

pattern - 格式

atZoneId - 时区

返回:

时间格式器

getDefaultFormatter

public static DateTimeFormatter getDefaultFormatter(@NonNull
                                                    @NonNull String pattern)

获取默认的时间格式器（严格模式），对应时间级别没有就赋默认值：1970-01-01 00:00:00.0，内容格式为英文

参数:

pattern - 格式

返回:

时间格式器

format

public static String format(@NonNull
                            @NonNull Temporal temporal,
                            ZoneId zoneId,
                            @NonNull
                            @NonNull String pattern)

格式化为指定时区和格式的字符串

参数:

temporal - 时间对象

zoneId - 时区

pattern - 格式

返回:

指定时区和格式的字符串

format

public static String format(@NonNull
                            @NonNull Temporal temporal,
                            ZoneId zoneId)

格式化为指定时区和格式的字符串，格式根据时间对象的类型判断

LocalDateTime、ZonedDateTime：DateUtils#defaultLocalDatePattern
LocalDate：DateUtils#defaultLocalDateTimePattern
LocalTime：DateUtils#defaultLocalTimePattern

参数:

temporal - 时间对象

zoneId - 时区

返回:

指定时区和格式的字符串

format

public static String format(@NonNull
                            @NonNull Temporal temporal,
                            @NonNull
                            @NonNull String pattern)

格式化为指定格式的字符串

参数:

temporal - 时间对象

pattern - 格式

返回:

指定格式的字符串

format

public static String format(@NonNull
                            @NonNull Temporal temporal)

格式化为指定格式的字符串，格式根据时间对象的类型判断

LocalDateTime、ZonedDateTime：DateUtils#defaultLocalDatePattern
LocalDate：DateUtils#defaultLocalDateTimePattern
LocalTime：DateUtils#defaultLocalTimePattern

参数:

temporal - 时间对象

返回:

指定格式的字符串

format

public static String format(@NonNull
                            @NonNull Date date,
                            ZoneId zoneId,
                            @NonNull
                            @NonNull String pattern)

格式化为指定时区和格式的字符串

参数:

date - 时间对象

zoneId - 时区

pattern - 格式

返回:

指定时区和格式的字符串

format

public static String format(@NonNull
                            @NonNull Date date,
                            @NonNull
                            @NonNull ZoneId zoneId)

格式化为指定时区的字符串

参数:

date - 时间对象

zoneId - 时区

返回:

指定时区的字符串

format

public static String format(@NonNull
                            @NonNull Date date,
                            @NonNull
                            @NonNull String pattern)

格式化为指定格式的字符串

参数:

date - 时间对象

pattern - 格式

返回:

指定格式的字符串

format

public static String format(@NonNull
                            @NonNull Date date)

格式化为 DateUtils#defaultDatePattern 的字符串

参数:

date - 时间对象

返回:

DateUtils#defaultDatePattern 格式的字符串

toDate

public static Date toDate(@NonNull
                          @NonNull Temporal temporal,
                          ZoneId zoneId)

转换为指定时区的 Date 对象

参数:

temporal - 时间对象

zoneId - 时区

返回:

指定时区的 Date 对象

toDate

public static Date toDate(@NonNull
                          @NonNull Temporal temporal)

转换为 Date 对象

参数:

temporal - 时间对象

返回:

Date 对象

parseLocalDateTime

public static LocalDateTime parseLocalDateTime(@NonNull
                                               @NonNull long timeStamp,
                                               ZoneId zoneId)

解析为指定时区的 LocalDateTime 对象

参数:

timeStamp - 时间戳

zoneId - 时区

返回:

指定时区的 LocalDateTime 对象

parseLocalDateTime

public static LocalDateTime parseLocalDateTime(@NonNull
                                               @NonNull long timeStamp)

解析为 LocalDateTime 对象

参数:

timeStamp - 时间戳

返回:

LocalDateTime 对象

parseLocalDateTime

public static LocalDateTime parseLocalDateTime(@NonNull
                                               @NonNull String source,
                                               ZoneId zoneId,
                                               @NonNull
                                               String... patterns)

满足任意格式时解析为指定时区的 LocalDateTime 对象

参数:

source - 字符串

zoneId - 时区

patterns - 多种格式

返回:

指定时区的 LocalDateTime 对象

parseLocalDateTime

public static LocalDateTime parseLocalDateTime(@NonNull
                                               @NonNull String source,
                                               ZoneId zoneId)

解析为指定时区的 LocalDateTime 对象，根据被解析字符串的长度判断格式

19：DateUtils#PATTERN_UUUU_MM_DD_HH_MM_SS
16：DateUtils#PATTERN_UUUU_MM_DD_HH_MM
10：DateUtils#PATTERN_UUUU_MM_DD
7：DateUtils#PATTERN_UUUU_MM
8：DateUtils#PATTERN_HH_MM_SS
5：DateUtils#PATTERN_HH_MM

参数:

source - 字符串

zoneId - 时区

返回:

指定时区的 LocalDateTime 对象

parseLocalDateTime

public static LocalDateTime parseLocalDateTime(@NonNull
                                               @NonNull String source,
                                               @NonNull
                                               String... patterns)

满足任意格式时解析为 LocalDateTime 对象

参数:

source - 字符串

patterns - 多种格式

返回:

LocalDateTime 对象

parseLocalDateTime

public static LocalDateTime parseLocalDateTime(@NonNull
                                               @NonNull String source)

解析为 LocalDateTime 对象，根据被解析字符串的长度判断格式

19：DateUtils#PATTERN_UUUU_MM_DD_HH_MM_SS
16：DateUtils#PATTERN_UUUU_MM_DD_HH_MM
10：DateUtils#PATTERN_UUUU_MM_DD
7：DateUtils#PATTERN_UUUU_MM
8：DateUtils#PATTERN_HH_MM_SS
5：DateUtils#PATTERN_HH_MM

参数:

source - 字符串

返回:

LocalDateTime 对象

parseLocalDate

public static LocalDate parseLocalDate(@NonNull
                                       @NonNull long timeStamp,
                                       ZoneId zoneId)

解析为指定时区的 LocalDate 对象

参数:

timeStamp - 被解析的时间戳

zoneId - 时区

返回:

指定时区的 LocalDate 对象

parseLocalDate

public static LocalDate parseLocalDate(@NonNull
                                       @NonNull long timeStamp)

解析为 LocalDate 对象

参数:

timeStamp - 时间戳

返回:

LocalDate 对象

parseLocalDate

public static LocalDate parseLocalDate(@NonNull
                                       @NonNull String source,
                                       ZoneId zoneId,
                                       @NonNull
                                       String... patterns)

满足任意格式时解析为指定时区的 LocalDate 对象

需要注意的是 LocalDate 不存在时区概念，此处是将 time 补足为 LocalTime.MIN 后再转换为 LocalDate

参数:

source - 字符串

zoneId - 时区

patterns - 多种格式

返回:

指定时区的 LocalDate 对象

parseLocalDate

public static LocalDate parseLocalDate(@NonNull
                                       @NonNull String source,
                                       ZoneId zoneId)

解析为指定时区的 LocalDate 对象，根据被解析字符串的长度判断格式

需要注意的是 LocalDate 不存在时区概念，此处是将 time 补足为 LocalTime.MIN 后再转换为 LocalDate

10：DateUtils#PATTERN_UUUU_MM_DD
7：DateUtils#PATTERN_UUUU_MM
8：DateUtils#PATTERN_HH_MM_SS
5：DateUtils#PATTERN_HH_MM

参数:

source - 字符串

zoneId - 时区

返回:

指定时区的 LocalDate 对象

parseLocalDate

public static LocalDate parseLocalDate(@NonNull
                                       @NonNull String source,
                                       @NonNull
                                       String... pattern)

满足任意格式就解析为 LocalDate 对象

参数:

source - 字符串

pattern - 格式

返回:

LocalDate 对象

parseLocalDate

public static LocalDate parseLocalDate(@NonNull
                                       @NonNull String source)

解析为 LocalDate 对象，根据被解析字符串的长度判断格式

10：DateUtils#PATTERN_UUUU_MM_DD
7：DateUtils#PATTERN_UUUU_MM
8：DateUtils#PATTERN_HH_MM_SS
5：DateUtils#PATTERN_HH_MM

参数:

source - 字符串

返回:

LocalDate 对象

parseLocalTime

public static LocalTime parseLocalTime(@NonNull
                                       @NonNull long timeStamp,
                                       ZoneId zoneId)

解析为指定时区的 LocalTime 对象

参数:

timeStamp - 时间戳

zoneId - 时区

返回:

指定时区的 LocalTime 对象

parseLocalTime

public static LocalTime parseLocalTime(@NonNull
                                       @NonNull long timeStamp)

解析为 LocalTime 对象

参数:

timeStamp - 时间戳

返回:

LocalTime 对象

parseLocalTime

public static LocalTime parseLocalTime(@NonNull
                                       @NonNull String source,
                                       ZoneId zoneId,
                                       @NonNull
                                       String... patterns)

满足任意格式时解析为指定时区的 LocalTime 对象

需要注意的是 LocalTime 不存在时区概念，此处是将 date 补足为 LocalDate.now() 后再转换为 LocalTime

参数:

source - 字符串

zoneId - 时区

patterns - 多个格式

返回:

指定时区的 LocalTime 对象

parseLocalTime

public static LocalTime parseLocalTime(@NonNull
                                       @NonNull String source,
                                       ZoneId zoneId)

解析为指定时区的 LocalTime 对象，根据被解析字符串的长度判断格式

需要注意的是 LocalTime 不存在时区概念，此处是将 date 补足为 LocalDate.now() 后再转换为 LocalTime

8：DateUtils#PATTERN_HH_MM_SS
5：DateUtils#PATTERN_HH_MM

参数:

source - 字符串

zoneId - 时区

返回:

指定时区的 LocalTime 对象

parseLocalTime

public static LocalTime parseLocalTime(@NonNull
                                       @NonNull String source,
                                       @NonNull
                                       String... patterns)

满足任意格式就解析为 LocalTime 对象

参数:

source - 字符串

patterns - 多种格式

返回:

LocalTime 对象

parseLocalTime

public static LocalTime parseLocalTime(@NonNull
                                       @NonNull String source)

解析为 LocalTime，根据被解析字符串的长度判断格式

8：DateUtils#PATTERN_HH_MM_SS
5：DateUtils#PATTERN_HH_MM

参数:

source - 被解析的字符串

返回:

LocalTime 对象

parseDate

public static Date parseDate(@NonNull
                             @NonNull long timeStamp,
                             ZoneId zoneId)

解析为指定时区的 Date 对象

参数:

timeStamp - 时间戳

zoneId - 时区

返回:

指定时区的 Date 对象

parseDate

public static Date parseDate(@NonNull
                             @NonNull long timeStamp)

解析为 Date 对象

参数:

timeStamp - 时间戳

返回:

Date 对象

parseDate

public static Date parseDate(@NonNull
                             @NonNull String source,
                             ZoneId zoneId,
                             @NonNull
                             String... patterns)

满足任意格式时解析为指定时区的 Date 对象

参数:

source - 字符串

zoneId - 时区

patterns - 多个格式

返回:

指定时区的 Date 对象

parseDate

public static Date parseDate(@NonNull
                             @NonNull String source,
                             @NonNull
                             @NonNull ZoneId zoneId)

解析为指定时区的 Date 对象

参数:

source - 字符串

zoneId - 时区

返回:

指定时区的 Date 对象

parseDate

public static Date parseDate(@NonNull
                             @NonNull String source,
                             @NonNull
                             String... patterns)

满足任意格式时解析为 Date 对象（org.apache.commons.lang3.time.DateUtils.parseDate）

参数:

source - 字符串

patterns - 多个格式

返回:

Date 对象

parseDate

public static Date parseDate(@NonNull
                             @NonNull String source)

解析为 Date 对象

参数:

source - 字符串

返回:

Date 对象

parse

public static <T> T parse(@NonNull
                          @NonNull long timeStamp,
                          ZoneId zoneId,
                          @NonNull
                          @NonNull Class<T> clazz)

解析为指定时区的时间对象

类型参数:

T - 时间类

参数:

timeStamp - 时间戳

zoneId - 时区

clazz - 时间类

返回:

指定时区的时间对象

parse

public static <T> T parse(@NonNull
                          @NonNull long timeStamp,
                          @NonNull
                          @NonNull Class<T> clazz)

解析为时间对象

类型参数:

T - 时间类

参数:

timeStamp - 时间戳

clazz - 时间类

返回:

时间对象

parse

public static <T> T parse(@NonNull
                          @NonNull String source,
                          ZoneId zoneId,
                          @NonNull
                          @NonNull Class<T> clazz,
                          @NonNull
                          String... patterns)

满足任意格式时解析为指定时区的时间对象

类型参数:

T - 时间类

参数:

source - 字符串

zoneId - 时区

clazz - 时间类

patterns - 多个格式

返回:

指定时区的时间对象

parse

public static <T> T parse(@NonNull
                          @NonNull String source,
                          @NonNull
                          @NonNull ZoneId zoneId,
                          @NonNull
                          @NonNull Class<T> clazz)

解析指定时区的时间对象

类型参数:

T - 时间类

参数:

source - 字符串

zoneId - 时区

clazz - 时间类

返回:

指定时区的时间对象

parse

public static <T> T parse(@NonNull
                          @NonNull String source,
                          @NonNull
                          @NonNull Class<T> clazz,
                          @NonNull
                          String... patterns)

满足任意格式时解析为时间对象

类型参数:

T - 时间类

参数:

source - 字符串

clazz - 时间类

patterns - 多个格式

返回:

时间对象

parse

public static <T> T parse(@NonNull
                          @NonNull String source,
                          @NonNull
                          @NonNull Class<T> clazz)

解析为时间对象

类型参数:

T - 时间类

参数:

source - 字符串

clazz - 时间类

返回:

时间对象

withZoneInstant

public static <T extends Temporal> T withZoneInstant(@NonNull
                                                     T temporal,
                                                     @NonNull
                                                     @NonNull ZoneId oldZoneId,
                                                     @NonNull
                                                     @NonNull ZoneId newZoneId)

从旧时区转换到新时区

ZonedDateTime 对象请直接用 .withZoneSameInstant(newZoneId)

类型参数:

T - 时间类 extends Temporal

参数:

temporal - 时间对象

oldZoneId - 旧时区

newZoneId - 新时区

返回:

转换时区后的时间对象

withZoneInstant

public static <T extends Temporal> T withZoneInstant(@NonNull
                                                     T temporal,
                                                     @NonNull
                                                     @NonNull ZoneId newZoneId)

从系统时区转换到新时区

类型参数:

T - 时间类 extends Temporal

参数:

temporal - 时间对象

newZoneId - 新时区

返回:

转换时区后的时间对象

withZoneInstant

public static Date withZoneInstant(@NonNull
                                   @NonNull Date date,
                                   @NonNull
                                   @NonNull ZoneId oldZoneId,
                                   @NonNull
                                   @NonNull ZoneId newZoneId)

从旧时区转换到新时区

参数:

date - Date 对象

oldZoneId - 旧时区

newZoneId - 新时区

返回:

转换时区后的 Date 对象

withZoneInstant

public static Date withZoneInstant(@NonNull
                                   @NonNull Date date,
                                   @NonNull
                                   @NonNull ZoneId newZoneId)

从系统时区转换到新时区

参数:

date - Date 对象

newZoneId - 新时区

返回:

转换时区后的 Date 对象

now

public static String now()

获取当前时间字符串

返回:

格式为 uuuu-MM-dd HH:mm:ss 的当前时间字符串

now

public static String now(@NonNull
                         @NonNull String pattern)

获取指定格式的当前时间字符串

参数:

pattern - 格式

返回:

指定格式的当前时间字符串

now

public static String now(@NonNull
                         @NonNull ZoneId zoneId)

获取指定时区的当前时间字符串

参数:

zoneId - 时区

返回:

指定时区的当前时间字符串

now

public static String now(@NonNull
                         @NonNull ZoneId zoneId,
                         @NonNull
                         @NonNull String pattern)

获取指定时区和格式的当前时间字符串

参数:

zoneId - 时区

pattern - 格式

返回:

指定时区和格式的当前时间字符串

plusOrMinus

public static <T extends Temporal> T plusOrMinus(@NonNull
                                                 T temporal,
                                                 @NonNull
                                                 @NonNull long augendOrMinuend,
                                                 ChronoUnit chronoUnit)

获取减去或加上指定类型数量的时间

参数:

temporal - 被加减的时间

augendOrMinuend - 数量

chronoUnit - 时间类型

返回:

加减后的时间

isIntersection

public static boolean isIntersection(@NonNull
                                     @NonNull LocalDateTime x1,
                                     @NonNull
                                     @NonNull LocalDateTime y1,
                                     @NonNull
                                     @NonNull LocalDateTime x2,
                                     @NonNull
                                     @NonNull LocalDateTime y2)

两个时间段是否交集

参数:

x1 - 时间段 1 开始时间

y1 - 时间段 1 结束时间

x2 - 时间段 2 开始时间

y2 - 时间段 2 结束时间

返回:

是否交集

getIntersection

public static LocalDateTime[] getIntersection(@NonNull
                                              @NonNull LocalDateTime x1,
                                              @NonNull
                                              @NonNull LocalDateTime y1,
                                              @NonNull
                                              @NonNull LocalDateTime x2,
                                              @NonNull
                                              @NonNull LocalDateTime y2)

获取两个时间段的交集

参数:

x1 - 时间段 1 开始时间

y1 - 时间段 1 结束时间

x2 - 时间段 2 开始时间

y2 - 时间段 2 结束时间

返回:

交集

getDifferenceSetsByIntersectional

public static List<LocalDateTime[]> getDifferenceSetsByIntersectional(@NonNull
                                                                      @NonNull LocalDateTime x1,
                                                                      @NonNull
                                                                      @NonNull LocalDateTime y1,
                                                                      @NonNull
                                                                      @NonNull LocalDateTime x2,
                                                                      @NonNull
                                                                      @NonNull LocalDateTime y2)

获取两个时间段交集时差集的时间段

参数:

x1 - 时间段 1 开始时间

y1 - 时间段 1 结束时间

x2 - 时间段 2 开始时间

y2 - 时间段 2 结束时间

返回:

差集

convertWeeks

public static String[] convertWeeks(@NonNull
                                    @NonNull String weeks,
                                    @NonNull
                                    @NonNull String splitRegex)

转换星期字符串为星期数组

参数:

weeks - 星期字符串

splitRegex - 星期分隔符

返回:

星期数组

convertWeeks

public static String[] convertWeeks(@NonNull
                                    @NonNull String weeks)

转换星期字符串为星期数组

参数:

weeks - 星期字符串

返回:

星期数组

getByWeeks

public static List<LocalDateTime> getByWeeks(@NonNull
                                             @NonNull String weeks,
                                             @NonNull
                                             LocalDateTime... times)

获取符合周几的时间

参数:

times - 时间

weeks - 周几，逗号或者无分隔，1 代表周一

返回:

符合周几的时间

getByRange

public static List<String> getByRange(@NonNull
                                      @NonNull LocalDateTime startTime,
                                      @NonNull
                                      @NonNull LocalDateTime endTime,
                                      @NonNull
                                      @NonNull String pattern)

获取日期范围内的所有日期

参数:

startTime - 开始时间

endTime - 结束时间

pattern - 结果集元素格式

返回:

日期范围内的所有日期

getByRangeAndWeeks

public static List<String> getByRangeAndWeeks(@NonNull
                                              @NonNull LocalDateTime startTime,
                                              @NonNull
                                              @NonNull LocalDateTime endTime,
                                              @NonNull
                                              @NonNull String weeks,
                                              @NonNull
                                              @NonNull String pattern)

获取日期范围内的所有指定星期，包含开始日期和结束日期

参数:

weeks - 周几，逗号或者无分隔，1 代表周一

pattern - 结果集元素的格式

返回:

所有指定星期的天集合

getByRangeAndWeeks

public static List<LocalDateTime> getByRangeAndWeeks(@NonNull
                                                     @NonNull LocalDateTime startTime,
                                                     @NonNull
                                                     @NonNull LocalDateTime endTime,
                                                     @NonNull
                                                     @NonNull String weeks)

获取日期范围内的所有指定星期，包含开始日期和结束日期

参数:

weeks - 周几，逗号或者无分隔，1 代表周一

返回:

所有指定星期的天集合