Dates (disjob-common 2.1.1 API)

java.lang.Object
- cn.ponfee.disjob.common.date.Dates

public class Dates
extends Object

Date utility

Java处理GMT/UTC日期时间

 时区：
   LocalDateTime：无时区
   Date(UTC0)：表示自格林威治时间(GMT)1970年1月1日0点经过指定的毫秒数后的时间点
   Instant(UTC0)：同Date
   ZonedDateTime：自带时区

 ZoneId子类：ZoneRegion、ZoneOffset
   ZoneId.of("Etc/GMT-8")                   -->    Etc/GMT-8
   ZoneId.of("GMT+8")                       -->    GMT+08:00
   ZoneId.of("UTC+8")                       -->    UTC+08:00
   ZoneId.of("Asia/Shanghai")               -->    Asia/Shanghai
   ZoneId.systemDefault()                   -->    Asia/Shanghai

 TimeZone子类（不支持UTC）：ZoneInfo
   TimeZone.getTimeZone("Etc/GMT-8")        -->    Etc/GMT-8
   TimeZone.getTimeZone("GMT+8")            -->    GMT+08:00
   TimeZone.getTimeZone("Asia/Shanghai")    -->    Asia/Shanghai
   TimeZone.getTimeZone(ZoneId.of("GMT+8")) -->    GMT+08:00
   TimeZone.getDefault()                    -->    Asia/Shanghai

作者:: Ponfee

字段概要

字段
限定符和类型	字段和说明
`static String`	`DATE_PATTERN` Date pattern
`static String`	`DATE_TO_STRING_PATTERN` Date format of `Date.toString()`
`static String`	`DATEFULL_PATTERN` Full datetime pattern
`static org.apache.commons.lang3.time.FastDateFormat`	`DATETIME_FORMAT` Fast date format for datetime pattern
`static String`	`DATETIME_PATTERN` Datetime pattern

构造器概要

构造器
构造器和说明

Dates()

构造器
构造器和说明
`Dates()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static long`	`clockDiff(Date start, Date end)` 计算两个日期的时间差（单位：秒）
`static long`	`currentUnixTimestamp()`
`static int`	`dayOfMonth(Date date)`
`static int`	`dayOfWeek(Date date)`
`static int`	`dayOfYear(Date date)`
`static int`	`daysBetween(Date start, Date end)` Returns a days between the two date(end-start)
`static Date`	`endOfDay(Date date)` 获取指定日期所在天的结束时间：yyyy-MM-dd 23:59:59
`static LocalDateTime`	`endOfDay(LocalDateTime dateTime)`
`static Date`	`endOfMonth(Date date)` 获取指定日期所在月的结束时间：yyyy-MM-月未 23:59:59
`static Date`	`endOfWeek(Date date)` 获取指定日期所在周的结束时间：yyyy-MM-周日 23:59:59
`static Date`	`endOfYear(Date date)` 获取指定日期所在月的结束时间：yyyy-12-31 23:59:59
`static String`	`format(Date date)` 格式化日期对象，格式为yyyy-MM-dd HH:mm:ss
`static String`	`format(Date date, String pattern)` 格式化日期对象
`static String`	`format(long timeMillis, String pattern)` 格式化日期对象
`static int`	`hourOfDay(Date date)`
`static boolean`	`isValidDate(String dateStr, String pattern)` 简单的日期格式校验
`static Date`	`max(Date a, Date b)` Returns the greater of two `Date` values.
`static Date`	`max(Date a, Date b, Date c)`
`static Date`	`min(Date a, Date b)` Returns the smaller of two `Date` values.
`static Date`	`minusDays(Date date, long days)` 减少天数
`static Date`	`minusHours(Date date, long hours)` 减少小时
`static Date`	`minusMillis(Date date, long millis)` 减少毫秒数
`static Date`	`minusMinutes(Date date, long minutes)` 减少分钟
`static Date`	`minusMonths(Date date, long months)` 减少月份
`static Date`	`minusSeconds(Date date, long seconds)` 减少秒数
`static Date`	`minusWeeks(Date date, long weeks)` 减少周
`static Date`	`minusYears(Date date, long years)` 减少年
`static Date`	`now()` 获取当前日期对象
`static String`	`now(String pattern)` 获取当前日期字符串
`static Date`	`ofTimeMillis(long timeMillis)` java（毫秒）时间戳
`static Date`	`ofTimeMillis(Long timeMillis)`
`static Date`	`ofUnixTimestamp(long unixTimestamp)` unix时间戳
`static Date`	`ofUnixTimestamp(Long unixTimestamp)`
`static Date`	`plusDays(Date date, long days)` 增加天数
`static Date`	`plusHours(Date date, long hours)` 增加小时
`static Date`	`plusMillis(Date date, long millis)` 增加毫秒数
`static Date`	`plusMinutes(Date date, long minutes)` 增加分钟
`static Date`	`plusMonths(Date date, long months)` 增加月份
`static Date`	`plusSeconds(Date date, long seconds)` 增加秒数
`static Date`	`plusWeeks(Date date, long weeks)` 增加周
`static Date`	`plusYears(Date date, long years)` 增加年
`static Date`	`random(Date begin, Date end)` 日期随机
`static Date`	`random(long beginTimeMills, long endTimeMills)`
`static Date`	`startOfDay(Date date)` 获取指定日期所在天的开始时间：yyyy-MM-dd 00:00:00
`static LocalDateTime`	`startOfDay(LocalDateTime dateTime)`
`static Date`	`startOfMonth(Date date)` 获取指定日期所在月的开始时间：yyyy-MM-01 00:00:00
`static Date`	`startOfWeek(Date date)` 获取指定日期所在周的开始时间：yyyy-MM-周一 00:00:00
`static Date`	`startOfYear(Date date)` 获取指定日期所在月的开始时间：yyyy-01-01 00:00:00
`static String`	`toCronExpression(Date date)`
`static String`	`toCronExpression(LocalDateTime dateTime)` Converts date time to cron expression
`static Date`	`toDate(LocalDate localDate)`
`static Date`	`toDate(LocalDateTime localDateTime)`
`static Date`	`toDate(String dateStr, String pattern)` 转换日期即字符串为Date对象
`static LocalDate`	`toLocalDate(Date date)`
`static LocalDateTime`	`toLocalDateTime(Date date)`
`static Date`	`withDayOfMonth(Date date, int dayOfMonth)` 获取指定时间所在月的n号，1<=day<=31
`static Date`	`withDayOfWeek(Date date, int dayOfWeek)` 获取指定时间所在周的周n，1<=day<=7
`static Date`	`withDayOfYear(Date date, int dayOfYear)` 获取指定时间所在年的n天，1<=day<=366
`static Date`	`zoneConvert(Date date, ZoneId sourceZone, ZoneId targetZone)` 时区转换
`static LocalDateTime`	`zoneConvert(LocalDateTime localDateTime, ZoneId sourceZone, ZoneId targetZone)` 时区转换

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料
- DATE_PATTERN
```
public static final String DATE_PATTERN
```
  Date pattern
  
  另请参阅:
  
  常量字段值
- DATETIME_PATTERN
```
public static final String DATETIME_PATTERN
```
  Datetime pattern
  
  另请参阅:
  
  常量字段值
- DATEFULL_PATTERN
```
public static final String DATEFULL_PATTERN
```
  Full datetime pattern
  
  另请参阅:
  
  常量字段值
- DATE_TO_STRING_PATTERN
```
public static final String DATE_TO_STRING_PATTERN
```
  Date format of Date.toString()
  
  另请参阅:
  
  常量字段值
- DATETIME_FORMAT
```
public static final org.apache.commons.lang3.time.FastDateFormat DATETIME_FORMAT
```
  Fast date format for datetime pattern

构造器详细资料
- Dates
```
public Dates()
```

方法详细资料

isValidDate

public static boolean isValidDate(String dateStr,
                                  String pattern)

简单的日期格式校验

参数:: dateStr - 输入日期，如(yyyy-MM-dd); pattern - 日期格式
返回:: 有效返回true, 反之false

now
```
public static Date now()
```
获取当前日期对象

返回:

当前日期对象

now
```
public static String now(String pattern)
```
获取当前日期字符串

参数:

pattern - 日期格式

返回:

当前日期字符串

toDate

public static Date toDate(String dateStr,
                          String pattern)

转换日期即字符串为Date对象

参数:: dateStr - 日期字符串; pattern - 日期格式
返回:: 日期对象

ofTimeMillis
```
public static Date ofTimeMillis(long timeMillis)
```
java（毫秒）时间戳

参数:

timeMillis - 毫秒时间戳

返回:

日期

ofTimeMillis

public static Date ofTimeMillis(Long timeMillis)

currentUnixTimestamp

public static long currentUnixTimestamp()

ofUnixTimestamp
```
public static Date ofUnixTimestamp(long unixTimestamp)
```
unix时间戳

参数:

unixTimestamp - unix时间戳

返回:

日期

ofUnixTimestamp

public static Date ofUnixTimestamp(Long unixTimestamp)

format

public static String format(Date date,
                            String pattern)

格式化日期对象

参数:: date - 日期对象; pattern - 日期格式
返回:: 当前日期字符串

format
```
public static String format(Date date)
```
格式化日期对象，格式为yyyy-MM-dd HH:mm:ss

参数:

date - 日期对象

返回:

日期字符串

format

public static String format(long timeMillis,
                            String pattern)

格式化日期对象

参数:: timeMillis - 毫秒; pattern - 格式
返回:: 日期字符串

plusMillis

public static Date plusMillis(Date date,
                              long millis)

增加毫秒数

参数:: date - 时间; millis - 毫秒数
返回:: 时间

plusSeconds

public static Date plusSeconds(Date date,
                               long seconds)

增加秒数

参数:: date - 时间; seconds - 秒数
返回:: 时间

plusMinutes

public static Date plusMinutes(Date date,
                               long minutes)

增加分钟

参数:: date - 时间; minutes - 分钟数
返回:: 时间

plusHours

public static Date plusHours(Date date,
                             long hours)

增加小时

参数:: date - 时间; hours - 小时数
返回:: 时间

plusDays

public static Date plusDays(Date date,
                            long days)

增加天数

参数:: date - 时间; days - 天数
返回:: 时间

plusWeeks

public static Date plusWeeks(Date date,
                             long weeks)

增加周

参数:: date - 时间; weeks - 周数
返回:: 时间

plusMonths

public static Date plusMonths(Date date,
                              long months)

增加月份

参数:: date - 时间; months - 月数
返回:: 时间

plusYears

public static Date plusYears(Date date,
                             long years)

增加年

参数:: date - 时间; years - 年数
返回:: 时间

minusMillis

public static Date minusMillis(Date date,
                               long millis)

减少毫秒数

参数:: date - 时间; millis - 毫秒数
返回:: 时间

minusSeconds

public static Date minusSeconds(Date date,
                                long seconds)

减少秒数

参数:: date - 时间; seconds - 秒数
返回:: 时间

minusMinutes

public static Date minusMinutes(Date date,
                                long minutes)

减少分钟

参数:: date - 时间; minutes - 分钟数
返回:: 时间

minusHours

public static Date minusHours(Date date,
                              long hours)

减少小时

参数:: date - 时间; hours - 小时数
返回:: 时间

minusDays

public static Date minusDays(Date date,
                             long days)

减少天数

参数:: date - 时间; days - 天数
返回:: 时间

minusWeeks

public static Date minusWeeks(Date date,
                              long weeks)

减少周

参数:: date - 时间; weeks - 周数
返回:: 时间

minusMonths

public static Date minusMonths(Date date,
                               long months)

减少月份

参数:: date - 时间; months - 月数
返回:: 时间

minusYears

public static Date minusYears(Date date,
                              long years)

减少年

参数:: date - 时间; years - 年数
返回:: 时间

startOfDay
```
public static Date startOfDay(Date date)
```
获取指定日期所在天的开始时间：yyyy-MM-dd 00:00:00

参数:

date - 时间

返回:

时间

endOfDay
```
public static Date endOfDay(Date date)
```
获取指定日期所在天的结束时间：yyyy-MM-dd 23:59:59

参数:

date - 时间

返回:

时间

startOfWeek
```
public static Date startOfWeek(Date date)
```
获取指定日期所在周的开始时间：yyyy-MM-周一 00:00:00

参数:

date - 日期

返回:

当前周第一天

endOfWeek
```
public static Date endOfWeek(Date date)
```
获取指定日期所在周的结束时间：yyyy-MM-周日 23:59:59

参数:

date - 日期

返回:

当前周最后一天

startOfMonth
```
public static Date startOfMonth(Date date)
```
获取指定日期所在月的开始时间：yyyy-MM-01 00:00:00

参数:

date - 日期

返回:

当前月的第一天

endOfMonth
```
public static Date endOfMonth(Date date)
```
获取指定日期所在月的结束时间：yyyy-MM-月未 23:59:59

参数:

date - 日期

返回:

当前月的最后一天

startOfYear
```
public static Date startOfYear(Date date)
```
获取指定日期所在月的开始时间：yyyy-01-01 00:00:00

参数:

date - 日期

返回:

当前年的第一天

endOfYear
```
public static Date endOfYear(Date date)
```
获取指定日期所在月的结束时间：yyyy-12-31 23:59:59

参数:

date - 日期

返回:

当前年的最后一天

withDayOfWeek
```
public static Date withDayOfWeek(Date date,
                                 int dayOfWeek)
```
获取指定时间所在周的周n，1<=day<=7

参数:

date - 相对日期

dayOfWeek - 1-星期一；2-星期二；...

返回:

本周周几的日期对象

withDayOfMonth
```
public static Date withDayOfMonth(Date date,
                                  int dayOfMonth)
```
获取指定时间所在月的n号，1<=day<=31

参数:

date - the date

dayOfMonth - the day of month

返回:

date

withDayOfYear
```
public static Date withDayOfYear(Date date,
                                 int dayOfYear)
```
获取指定时间所在年的n天，1<=day<=366

参数:

date - the date

dayOfYear - the day of year

返回:

date

dayOfYear

public static int dayOfYear(Date date)

dayOfMonth

public static int dayOfMonth(Date date)

dayOfWeek

public static int dayOfWeek(Date date)

hourOfDay

public static int hourOfDay(Date date)

clockDiff
```
public static long clockDiff(Date start,
                             Date end)
```
计算两个日期的时间差（单位：秒）

参数:

start - 开始时间

end - 结束时间

返回:

时间间隔

daysBetween
```
public static int daysBetween(Date start,
                              Date end)
```
Returns a days between the two date(end-start)

参数:

start - the start date

end - the end date

返回:

a number of between start to end days

另请参阅:

ChronoUnit.between(Temporal, Temporal)

random

public static Date random(Date begin,
                          Date end)

日期随机

参数:: begin - 开发日期; end - 结束日期
返回:

random

public static Date random(long beginTimeMills,
                          long endTimeMills)

min
```
public static Date min(Date a,
                       Date b)
```
Returns the smaller of two Date values.

参数:

a - the first Date

b - the second Date

返回:

the smallest of a and b

max
```
public static Date max(Date a,
                       Date b)
```
Returns the greater of two Date values.

参数:

a - the first Date

b - the second Date

返回:

the greatest of a and b

max

public static Date max(Date a,
                       Date b,
                       Date c)

toLocalDateTime

public static LocalDateTime toLocalDateTime(Date date)

toDate

public static Date toDate(LocalDateTime localDateTime)

toLocalDate

public static LocalDate toLocalDate(Date date)

toDate

public static Date toDate(LocalDate localDate)

startOfDay

public static LocalDateTime startOfDay(LocalDateTime dateTime)

endOfDay

public static LocalDateTime endOfDay(LocalDateTime dateTime)

zoneConvert

public static Date zoneConvert(Date date,
                               ZoneId sourceZone,
                               ZoneId targetZone)

时区转换

参数:: date - the date; sourceZone - the source zone id; targetZone - the target zone id
返回:: date of target zone id

zoneConvert

public static LocalDateTime zoneConvert(LocalDateTime localDateTime,
                                        ZoneId sourceZone,
                                        ZoneId targetZone)

时区转换

参数:: localDateTime - the localDateTime; sourceZone - the source zone id; targetZone - the target zone id
返回:: localDateTime of target zone id

toCronExpression

public static String toCronExpression(Date date)

toCronExpression
```
public static String toCronExpression(LocalDateTime dateTime)
```
Converts date time to cron expression

参数:

dateTime - the local date time

返回:

cron expression of the spec date

类 Dates

字段概要

构造器概要

方法概要

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

字段详细资料

DATE_PATTERN

DATETIME_PATTERN

DATEFULL_PATTERN

DATE_TO_STRING_PATTERN

DATETIME_FORMAT

构造器详细资料

Dates

方法详细资料

isValidDate

now

now

toDate

ofTimeMillis

ofTimeMillis

currentUnixTimestamp

ofUnixTimestamp

ofUnixTimestamp

format

format

format

plusMillis

plusSeconds

plusMinutes

plusHours

plusDays

plusWeeks

plusMonths

plusYears

minusMillis

minusSeconds

minusMinutes

minusHours

minusDays

minusWeeks

minusMonths

minusYears

startOfDay

endOfDay

startOfWeek

endOfWeek

startOfMonth

endOfMonth

startOfYear

endOfYear

withDayOfWeek

withDayOfMonth

withDayOfYear

dayOfYear

dayOfMonth

dayOfWeek

hourOfDay

clockDiff

daysBetween

random

random

min

max

max

toLocalDateTime

toDate

toLocalDate

toDate

startOfDay

endOfDay

zoneConvert

zoneConvert

toCronExpression

toCronExpression