DateUtils (Dapware Commons 1.0.12 API)

java.lang.Object
- com.digiwin.dap.middleware.util.DateUtils

```
public class DateUtils
extends Object
```
日期工具类

从以下版本开始:

1.0.12

作者:

fobgochod, chenzhuang

字段概要

字段
限定符和类型	字段和说明
`static String`	`PATTERN_DATE` 日期格式：yyyy-MM-dd
`static String`	`PATTERN_DATETIME` 日期时间格式：yyyy-MM-dd HH:mm:ss
`static String`	`PATTERN_PATTERN_NORM_DATETIME_MS` 日期时间格式：yyyy-MM-dd HH:mm:ss.SSS
`static String`	`PATTERN_PURE_DATE` 日期格式：yyyyMMdd
`static String`	`PATTERN_PURE_DATETIME` 日期时间格式：yyyyMMddHHmmss
`static String`	`PATTERN_PURE_DATETIME_MS` 日期时间格式：yyyyMMddHHmmssSSS
`static String`	`PATTERN_PURE_TIME` 时间格式：HHmmss
`static String`	`PATTERN_TIME` 时间格式：HH:mm:ss

构造器概要

构造器
构造器和说明

DateUtils()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static LocalDateTime`	`beginOfDay(LocalDateTime time)` 修改为一天的开始时间，例如：2020-02-02 00:00:00,000
`static Duration`	`between(Date startDate, Date endDate)` 比较2个时间差
`static Period`	`between(LocalDate startTimeInclude, LocalDate endTimeExclude)` 获取两个日期的表象时间差，如果结束时间早于开始时间，获取结果为负。
`static Duration`	`between(LocalDateTime startTimeInclude, LocalDateTime endTimeExclude)` 获取两个日期的差，如果结束时间早于开始时间，获取结果为负。
`static LocalDateTime`	`endOfDay(LocalDateTime time)` 修改为一天的结束时间，例如：2020-02-02 23:59:59
`static String`	`format(Date date, String pattern)` Date 日期格式化
`static String`	`format(TemporalAccessor temporal, String pattern)` java8 日期格式化
`static String`	`formatDate(Date date)` Date 日期格式化格式 yyyy-MM-dd
`static String`	`formatDate(TemporalAccessor temporal)` java8 日期格式化格式 yyyy-MM-dd
`static String`	`formatDatePure(TemporalAccessor temporal)` java8 日期时间格式化格式 yyyyMMdd
`static String`	`formatDateTime(Date date)` Date 日期时间格式化格式 yyyy-MM-dd HH:mm:ss
`static String`	`formatDateTime(TemporalAccessor temporal)` java8 日期时间格式化格式 yyyy-MM-dd HH:mm:ss
`static String`	`formatDateTimeMsNorm(TemporalAccessor temporal)` java8 日期时间格式化（含毫秒）格式 yyyy-MM-dd HH:mm:ss.SSS
`static String`	`formatDateTimeMsPure(TemporalAccessor temporal)` java8 日期时间格式化（含毫秒）格式 yyyyMMddHHmmssSSS
`static String`	`formatDateTimePure(TemporalAccessor temporal)` java8 日期时间格式化格式 yyyyMMddHHmmss
`static String`	`formatTime(Date date)` Date 时间格式化格式 HH:mm:ss
`static String`	`formatTime(TemporalAccessor temporal)` java8 时间格式化格式 HH:mm:ss
`static String`	`formatTimePure(TemporalAccessor temporal)` java8 时间格式化格式 HHmmss
`static LocalDateTime`	`getDateByStr(String dateStr)`
`static LocalDateTime`	`getDateByStr(String dateStr, String formatter)`
`static boolean`	`isOverlap(ChronoLocalDateTime<?> realStartTime, ChronoLocalDateTime<?> realEndTime, ChronoLocalDateTime<?> startTime, ChronoLocalDateTime<?> endTime)` 检查两个时间段是否有时间重叠重叠指两个时间段是否有交集
`static boolean`	`isWeekend(LocalDate localDate)` 是否为周末（周六或周日）
`static boolean`	`isWeekend(LocalDateTime localDateTime)` 是否为周末（周六或周日）
`static LocalDateTime`	`now()` 当前时间，默认时区
`static Date`	`parse(String dateStr, DateFormat format)` 将字符串转换为时间
`static Date`	`parse(String dateStr, String pattern)` 将字符串转换为时间
`static Date`	`parseDate(String dateStr)` 解析日期时间字符串格式 yyyy-MM-dd
`static Date`	`parseDateTime(String dateStr)` 解析日期时间字符串
`static LocalDateTime`	`parseLocalDate(String dateStr)` 解析日期字符串格式 yyyy-MM-dd
`static LocalDateTime`	`parseLocalDateTime(String dateStr)` 解析日期时间字符串格式 yyyy-MM-dd HH:mm:ss
`static LocalDateTime`	`parseLocalDateTime(String dateStr, DateTimeFormatter formatter)` 将字符串转换为时间
`static LocalDateTime`	`parseLocalDateTime(String dateStr, String pattern)` 将字符串转换为时间
`static LocalDateTime`	`parseLocalTime(String dateStr)` 解析时间字符串格式 HH:mm:ss
`static Date`	`parseTime(String dateStr)` 解析日期时间字符串格式 HH:mm:ss
`static Date`	`toDate(LocalDate localDate)` LocalDate 转换成 date
`static Date`	`toDate(LocalDateTime dateTime)` LocalDateTime 转换成 date
`static LocalDateTime`	`toDateTime(Date date)` date 转换成java8 时间LocalDateTime
`static LocalDateTime`	`toDateTime(Instant instant)` Instant 转时间 LocalDateTime
`static LocalDateTime`	`toDateTime(long milliseconds)` milliseconds 转换成 java8 时间LocalDateTime
`static Instant`	`toInstant(LocalDateTime dateTime)` LocalDateTime 时间转 Instant
`static long`	`toMilliseconds(LocalDate localDate)` localDate 转换成毫秒数
`static long`	`toMilliseconds(LocalDateTime localDateTime)` localDateTime 转换成毫秒数

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

- 字段详细资料
  - PATTERN_DATETIME
```
public static final String PATTERN_DATETIME
```
    日期时间格式：yyyy-MM-dd HH:mm:ss
    
    另请参阅:
    
    常量字段值
  - PATTERN_DATE
```
public static final String PATTERN_DATE
```
    日期格式：yyyy-MM-dd
    
    另请参阅:
    
    常量字段值
  - PATTERN_TIME
```
public static final String PATTERN_TIME
```
    时间格式：HH:mm:ss
    
    另请参阅:
    
    常量字段值
  - PATTERN_PURE_DATETIME
```
public static final String PATTERN_PURE_DATETIME
```
    日期时间格式：yyyyMMddHHmmss
    
    另请参阅:
    
    常量字段值
  - PATTERN_PURE_DATE
```
public static final String PATTERN_PURE_DATE
```
    日期格式：yyyyMMdd
    
    另请参阅:
    
    常量字段值
  - PATTERN_PURE_TIME
```
public static final String PATTERN_PURE_TIME
```
    时间格式：HHmmss
    
    另请参阅:
    
    常量字段值
  - PATTERN_PATTERN_NORM_DATETIME_MS
```
public static final String PATTERN_PATTERN_NORM_DATETIME_MS
```
    日期时间格式：yyyy-MM-dd HH:mm:ss.SSS
    
    另请参阅:
    
    常量字段值
  - PATTERN_PURE_DATETIME_MS
```
public static final String PATTERN_PURE_DATETIME_MS
```
    日期时间格式：yyyyMMddHHmmssSSS
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - DateUtils
```
public DateUtils()
```
- 方法详细资料
  - getDateByStr
```
public static LocalDateTime getDateByStr(String dateStr)
```
  - getDateByStr
```
public static LocalDateTime getDateByStr(String dateStr,
                                         String formatter)
```
  - now
```
public static LocalDateTime now()
```
    当前时间，默认时区
    
    返回:
    
    LocalDateTime
  - formatDateTime
```
public static String formatDateTime(Date date)
```
    Date 日期时间格式化格式 yyyy-MM-dd HH:mm:ss
    
    参数:
    
    date - 时间
    
    返回:
    
    格式化后的时间
  - formatDate
```
public static String formatDate(Date date)
```
    Date 日期格式化格式 yyyy-MM-dd
    
    参数:
    
    date - 时间
    
    返回:
    
    格式化后的时间
  - formatTime
```
public static String formatTime(Date date)
```
    Date 时间格式化格式 HH:mm:ss
    
    参数:
    
    date - 时间
    
    返回:
    
    格式化后的时间
  - format
```
public static String format(Date date,
                            String pattern)
```
    Date 日期格式化
    
    参数:
    
    date - 时间
    
    pattern - 表达式
    
    返回:
    
    格式化后的时间
  - formatDateTime
```
public static String formatDateTime(TemporalAccessor temporal)
```
    java8 日期时间格式化格式 yyyy-MM-dd HH:mm:ss
    
    参数:
    
    temporal - 时间
    
    返回:
    
    格式化后的时间
  - formatDate
```
public static String formatDate(TemporalAccessor temporal)
```
    java8 日期格式化格式 yyyy-MM-dd
    
    参数:
    
    temporal - 时间
    
    返回:
    
    格式化后的时间
  - formatTime
```
public static String formatTime(TemporalAccessor temporal)
```
    java8 时间格式化格式 HH:mm:ss
    
    参数:
    
    temporal - 时间
    
    返回:
    
    格式化后的时间
  - formatDateTimePure
```
public static String formatDateTimePure(TemporalAccessor temporal)
```
    java8 日期时间格式化格式 yyyyMMddHHmmss
    
    参数:
    
    temporal - 时间
    
    返回:
    
    格式化后的时间
  - formatDatePure
```
public static String formatDatePure(TemporalAccessor temporal)
```
    java8 日期时间格式化格式 yyyyMMdd
    
    参数:
    
    temporal - 时间
    
    返回:
    
    格式化后的时间
  - formatTimePure
```
public static String formatTimePure(TemporalAccessor temporal)
```
    java8 时间格式化格式 HHmmss
    
    参数:
    
    temporal - 时间
    
    返回:
    
    格式化后的时间
  - formatDateTimeMsNorm
```
public static String formatDateTimeMsNorm(TemporalAccessor temporal)
```
    java8 日期时间格式化（含毫秒）格式 yyyy-MM-dd HH:mm:ss.SSS
    
    参数:
    
    temporal - 时间
    
    返回:
    
    格式化后的时间
  - formatDateTimeMsPure
```
public static String formatDateTimeMsPure(TemporalAccessor temporal)
```
    java8 日期时间格式化（含毫秒）格式 yyyyMMddHHmmssSSS
    
    参数:
    
    temporal - 时间
    
    返回:
    
    格式化后的时间
  - format
```
public static String format(TemporalAccessor temporal,
                            String pattern)
```
    java8 日期格式化
    
    参数:
    
    temporal - 时间
    
    pattern - 表达式
    
    返回:
    
    格式化后的时间
  - parseDateTime
```
public static Date parseDateTime(String dateStr)
```
    解析日期时间字符串
    
    参数:
    
    dateStr - 时间字符串
    
    返回:
    
    时间
  - parseDate
```
public static Date parseDate(String dateStr)
```
    解析日期时间字符串格式 yyyy-MM-dd
    
    参数:
    
    dateStr - 时间字符串
    
    返回:
    
    时间
  - parseTime
```
public static Date parseTime(String dateStr)
```
    解析日期时间字符串格式 HH:mm:ss
    
    参数:
    
    dateStr - 时间字符串
    
    返回:
    
    时间
  - parse
```
public static Date parse(String dateStr,
                         String pattern)
```
    将字符串转换为时间
    
    参数:
    
    dateStr - 时间字符串
    
    pattern - 表达式
    
    返回:
    
    时间
  - parse
```
public static Date parse(String dateStr,
                         DateFormat format)
```
    将字符串转换为时间
    
    参数:
    
    dateStr - 时间字符串
    
    format - ConcurrentDateFormat
    
    返回:
    
    时间
  - parseLocalDateTime
```
public static LocalDateTime parseLocalDateTime(String dateStr)
```
    解析日期时间字符串格式 yyyy-MM-dd HH:mm:ss
    
    参数:
    
    dateStr - 时间字符串
    
    返回:
    
    时间
  - parseLocalDate
```
public static LocalDateTime parseLocalDate(String dateStr)
```
    解析日期字符串格式 yyyy-MM-dd
    
    参数:
    
    dateStr - 时间字符串
    
    返回:
    
    时间
  - parseLocalTime
```
public static LocalDateTime parseLocalTime(String dateStr)
```
    解析时间字符串格式 HH:mm:ss
    
    参数:
    
    dateStr - 时间字符串
    
    返回:
    
    时间
  - parseLocalDateTime
```
public static LocalDateTime parseLocalDateTime(String dateStr,
                                               String pattern)
```
    将字符串转换为时间
    
    参数:
    
    dateStr - 时间字符串
    
    pattern - 表达式
    
    返回:
    
    时间
  - parseLocalDateTime
```
public static LocalDateTime parseLocalDateTime(String dateStr,
                                               DateTimeFormatter formatter)
```
    将字符串转换为时间
    
    参数:
    
    dateStr - 时间字符串
    
    formatter - DateTimeFormatter
    
    返回:
    
    时间
  - toInstant
```
public static Instant toInstant(LocalDateTime dateTime)
```
    LocalDateTime 时间转 Instant
    
    参数:
    
    dateTime - 时间
    
    返回:
    
    Instant
  - toDateTime
```
public static LocalDateTime toDateTime(Instant instant)
```
    Instant 转时间 LocalDateTime
    
    参数:
    
    instant - Instant
    
    返回:
    
    Instant
  - toDate
```
public static Date toDate(LocalDateTime dateTime)
```
    LocalDateTime 转换成 date
    
    参数:
    
    dateTime - LocalDateTime
    
    返回:
    
    Date
  - toDate
```
public static Date toDate(LocalDate localDate)
```
    LocalDate 转换成 date
    
    参数:
    
    localDate - LocalDate
    
    返回:
    
    Date
  - toMilliseconds
```
public static long toMilliseconds(LocalDateTime localDateTime)
```
    localDateTime 转换成毫秒数
    
    参数:
    
    localDateTime - LocalDateTime
    
    返回:
    
    long
  - toMilliseconds
```
public static long toMilliseconds(LocalDate localDate)
```
    localDate 转换成毫秒数
    
    参数:
    
    localDate - LocalDate
    
    返回:
    
    long
  - toDateTime
```
public static LocalDateTime toDateTime(Date date)
```
    date 转换成java8 时间LocalDateTime
    
    参数:
    
    date - Date
    
    返回:
    
    LocalDateTime
  - toDateTime
```
public static LocalDateTime toDateTime(long milliseconds)
```
    milliseconds 转换成 java8 时间LocalDateTime
    
    参数:
    
    milliseconds - 毫秒数
    
    返回:
    
    LocalDateTime
  - between
```
public static Duration between(LocalDateTime startTimeInclude,
                               LocalDateTime endTimeExclude)
```
    获取两个日期的差，如果结束时间早于开始时间，获取结果为负。
    返回结果为Duration对象，通过调用toXXX方法返回相差单位
    
    参数:
    
    startTimeInclude - 开始时间（包含）
    
    endTimeExclude - 结束时间（不包含）
    
    返回:
    
    时间差 Duration对象
  - between
```
public static Period between(LocalDate startTimeInclude,
                             LocalDate endTimeExclude)
```
    获取两个日期的表象时间差，如果结束时间早于开始时间，获取结果为负。年月日为单位
    比如2011年2月1日，和2021年8月11日，日相差了10天，月相差6月
    
    参数:
    
    startTimeInclude - 开始时间（包括）
    
    endTimeExclude - 结束时间（不包括）
    
    返回:
    
    时间差
    
    从以下版本开始:
    
    5.4.5
  - between
```
public static Duration between(Date startDate,
                               Date endDate)
```
    比较2个时间差
    
    参数:
    
    startDate - 开始时间
    
    endDate - 结束时间
    
    返回:
    
    时间间隔
  - beginOfDay
```
public static LocalDateTime beginOfDay(LocalDateTime time)
```
    修改为一天的开始时间，例如：2020-02-02 00:00:00,000
    
    参数:
    
    time - 日期时间
    
    返回:
    
    一天的开始时间
  - endOfDay
```
public static LocalDateTime endOfDay(LocalDateTime time)
```
    修改为一天的结束时间，例如：2020-02-02 23:59:59
    
    参数:
    
    time - 日期时间
    
    返回:
    
    一天的结束时间
  - isWeekend
```
public static boolean isWeekend(LocalDateTime localDateTime)
```
    是否为周末（周六或周日）
    
    参数:
    
    localDateTime - 判定的日期LocalDateTime
    
    返回:
    
    是否为周末（周六或周日）
  - isWeekend
```
public static boolean isWeekend(LocalDate localDate)
```
    是否为周末（周六或周日）
    
    参数:
    
    localDate - 判定的日期LocalDate
    
    返回:
    
    是否为周末（周六或周日）
  - isOverlap
```
public static boolean isOverlap(ChronoLocalDateTime<?> realStartTime,
                                ChronoLocalDateTime<?> realEndTime,
                                ChronoLocalDateTime<?> startTime,
                                ChronoLocalDateTime<?> endTime)
```
    检查两个时间段是否有时间重叠
    重叠指两个时间段是否有交集
    
    参数:
    
    realStartTime - 第一个时间段的开始时间
    
    realEndTime - 第一个时间段的结束时间
    
    startTime - 第二个时间段的开始时间
    
    endTime - 第二个时间段的结束时间
    
    返回:
    
    true 表示时间有重合

类 DateUtils

字段概要

构造器概要

方法概要

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

字段详细资料

PATTERN_DATETIME

PATTERN_DATE

PATTERN_TIME

PATTERN_PURE_DATETIME

PATTERN_PURE_DATE

PATTERN_PURE_TIME

PATTERN_PATTERN_NORM_DATETIME_MS

PATTERN_PURE_DATETIME_MS

构造器详细资料

DateUtils

方法详细资料

getDateByStr

getDateByStr

now

formatDateTime

formatDate

formatTime

format

formatDateTime

formatDate

formatTime

formatDateTimePure

formatDatePure

formatTimePure

formatDateTimeMsNorm

formatDateTimeMsPure

format

parseDateTime

parseDate

parseTime

parse

parse

parseLocalDateTime

parseLocalDate

parseLocalTime

parseLocalDateTime

parseLocalDateTime

toInstant

toDateTime

toDate

toDate

toMilliseconds

toMilliseconds

toDateTime

toDateTime

between

between

between

beginOfDay

endOfDay

isWeekend

isWeekend

isOverlap