DateTimeFormatUtils (myoss-starter-core 2.1.10.RELEASE API)

java.lang.Object
- app.myoss.cloud.core.lang.base.DateTimeFormatUtils

```
public class DateTimeFormatUtils
extends Object
```
日期时间格式化工具类

Since:

2018年5月23日上午1:41:48

Author:

Jerry.Chen

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`HH_MM_SS` HH:mm:ss
`static String`	`YYYY_MM_DD` yyyy-MM-dd
`static String`	`YYYY_MM_DD_CN` yyyy年MM月dd日
`static String`	`YYYY_MM_DD_HH_MM_SS` yyyy-MM-dd HH:mm:ss
`static String`	`YYYYMM` yyyyMM
`static String`	`YYYYMMDD` yyyyMMdd
`static String`	`YYYYMMDDHHMMSS` yyyyMMddHHmmss

Constructor Summary

Constructors
Constructor and Description

DateTimeFormatUtils()

Constructors
Constructor and Description
`DateTimeFormatUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static boolean`	`checkDateTimeOverlap(Date srcEffectiveTime, Date srcExpiryTime, Date targetEffectiveTime, Date targetExpiryTime)` 校验时间区间是否有重叠，比较"源的时间区间"是否在"目标的时间区间"内
`static boolean`	`checkDateTimeOverlap(LocalDateTime srcEffectiveTime, LocalDateTime srcExpiryTime, LocalDateTime targetEffectiveTime, LocalDateTime targetExpiryTime)` 校验时间区间是否有重叠，比较"源的时间区间"是否在"目标的时间区间"内
`static boolean`	`isSameDay(Date date1, Date date2)` 比较两个日期是否相同，会比较时间部分
`static boolean`	`isSameDay(LocalDateTime date1, LocalDateTime date2)` 比较两个日期是否相同，会比较时间部分
`static Date`	`parse2Date(String date)` 将字符串日期：yyyy-MM-dd 转换为日期
`static Date`	`parse2DateCN(String date)` 将字符串日期：yyyy年MM月dd日转换为日期
`static Date`	`parse2DateEN(String date)` 将字符串日期：yyyyMMdd 转换为日期
`static Date`	`parse2DateTimeCN(String date)` 将字符串日期：yyyy-MM-dd HH:mm:ss 转换为日期
`static Date`	`parse2DateTimeEN(String date)` 将字符串日期：yyyyMMddHHmmss 转换为日期
`static Date`	`parse2YearMonth(String date)` 将字符串日期：yyyyMM 转换为日期（返回当月的1号）
`static LocalDate`	`parseToDate(String date)` 将字符串日期：yyyy-MM-dd 转换为日期
`static LocalDate`	`parseToDateCN(String date)` 将字符串日期：yyyy年MM月dd日转换为日期
`static LocalDateTime`	`parseToDateEN(String date)` 将字符串日期：yyyyMMdd 转换为日期
`static LocalDateTime`	`parseToDateTimeCN(String date)` 将字符串日期：yyyy-MM-dd HH:mm:ss 转换为日期
`static LocalDateTime`	`parseToDateTimeEN(String date)` 将字符串日期：yyyyMMddHHmmss 转换为日期
`static LocalDateTime`	`parseToYearMonth(String date)` 将字符串日期：yyyyMM 转换为日期（返回当月的1号）
`static String`	`print2Date(Date date)` 转换日期为：yyyy-MM-dd
`static String`	`print2Date(LocalDateTime date)` 转换日期为：yyyy-MM-dd
`static String`	`print2DateCN(Date date)` 转换日期为：yyyy年MM月dd日
`static String`	`print2DateCN(LocalDateTime date)` 转换日期为：yyyy年MM月dd日
`static String`	`print2DateEN(Date date)` 转换日期为：yyyyMMdd
`static String`	`print2DateEN(LocalDate date)` 转换日期为：yyyyMMdd
`static String`	`print2DateEN(LocalDateTime date)` 转换日期为：yyyyMMdd
`static String`	`print2DateTimeCN(Date date)` 转换日期为：yyyy-MM-dd HH:mm:ss
`static String`	`print2DateTimeCN(LocalDateTime date)` 转换日期为：yyyy-MM-dd HH:mm:ss
`static String`	`print2DateTimeEN(Date date)` 转换日期为：yyyyMMddHHmmss
`static String`	`print2DateTimeEN(LocalDateTime date)` 转换日期为：yyyyMMddHHmmss
`static String`	`print2Time(Date date)` 转换日期为：HH:mm:ss
`static String`	`print2Time(LocalDateTime date)` 转换日期为：HH:mm:ss
`static String`	`print2YearMonth(Date date)` 转换日期为：yyyyMM
`static String`	`print2YearMonth(LocalDate date)` 转换日期为：yyyyMM
`static String`	`print2YearMonth(LocalDateTime date)` 转换日期为：yyyyMM
`static Calendar`	`toCalendar(LocalDate localDate)` 将 `LocalDate` 按默认时区转换为 `Calendar`
`static Calendar`	`toCalendar(LocalDateTime localDateTime)` 将 `LocalDateTime` 按默认时区转换为 `Calendar`
`static Calendar`	`toCalendar(ZonedDateTime zonedDateTime)` 将 `ZonedDateTime` 按时区转换为 `Calendar`
`static Date`	`toDate(LocalDate localDate)` 将 `LocalDate` 按默认时区转换为 `Date`
`static Date`	`toDate(LocalDateTime localDateTime)` 将 `LocalDateTime` 按默认时区转换为 `Date`
`static LocalDate`	`toLocalDate(Date date)` 将 `Date` 按默认时区转换为 `LocalDate`
`static LocalDateTime`	`toLocalDateTime(Date date)` 将 `Date` 按默认时区转换为 `LocalDateTime`
`static ZonedDateTime`	`toZonedDateTime(Calendar calendar)` 将 `ZonedDateTime` 按时区转换为 `Calendar`
`static Date`	`withTimeAtEndOfDay(Date date)` 获取日期当天的 23:59:59.999 Example:
`static Date`	`withTimeAtEndOfDay(LocalDateTime date)` 获取日期当天的 23:59:59.999 Example:
`static Date`	`withTimeAtEndOfDayAndRemoveNano(Date date)` 获取日期当天的 23:59:59.000 Example:
`static Date`	`withTimeAtEndOfDayAndRemoveNano(LocalDateTime date)` 获取日期当天的 23:59:59.000 Example:
`static Date`	`withTimeAtStartOfDay(Date date)` 获取日期当天的 00:00:00。 Example:
`static Date`	`withTimeAtStartOfDay(LocalDateTime date)` 获取日期当天的 00:00:00。 Example:

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - YYYY_MM_DD_HH_MM_SS
```
public static final String YYYY_MM_DD_HH_MM_SS
```
    yyyy-MM-dd HH:mm:ss
    
    See Also:
    
    Constant Field Values
  - YYYY_MM_DD
```
public static final String YYYY_MM_DD
```
    yyyy-MM-dd
    
    See Also:
    
    Constant Field Values
  - YYYY_MM_DD_CN
```
public static final String YYYY_MM_DD_CN
```
    yyyy年MM月dd日
    
    See Also:
    
    Constant Field Values
  - YYYYMMDDHHMMSS
```
public static final String YYYYMMDDHHMMSS
```
    yyyyMMddHHmmss
    
    See Also:
    
    Constant Field Values
  - YYYYMMDD
```
public static final String YYYYMMDD
```
    yyyyMMdd
    
    See Also:
    
    Constant Field Values
  - YYYYMM
```
public static final String YYYYMM
```
    yyyyMM
    
    See Also:
    
    Constant Field Values
  - HH_MM_SS
```
public static final String HH_MM_SS
```
    HH:mm:ss
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - DateTimeFormatUtils
```
public DateTimeFormatUtils()
```
- Method Detail
  - toDate
```
public static Date toDate(LocalDateTime localDateTime)
```
    将 LocalDateTime 按默认时区转换为 Date
    
    Parameters:
    
    localDateTime - 表示与时区无关的日期和时间信息，不直接对应时刻，需要通过时区转换
    
    Returns:
    
    Java 1.8 以前的日期
  - toDate
```
public static Date toDate(LocalDate localDate)
```
    将 LocalDate 按默认时区转换为 Date
    
    Parameters:
    
    localDate - 表示与时区无关的日期，只有日期信息，没有时间信息
    
    Returns:
    
    Java 1.8 以前的日期
  - toCalendar
```
public static Calendar toCalendar(LocalDateTime localDateTime)
```
    将 LocalDateTime 按默认时区转换为 Calendar
    
    Parameters:
    
    localDateTime - 表示与时区无关的日期和时间信息，不直接对应时刻，需要通过时区转换
    
    Returns:
    
    Java 1.8 以前的日历
  - toCalendar
```
public static Calendar toCalendar(LocalDate localDate)
```
    将 LocalDate 按默认时区转换为 Calendar
    
    Parameters:
    
    localDate - 表示与时区无关的日期，只有日期信息，没有时间信息
    
    Returns:
    
    Java 1.8 以前的日历
  - toCalendar
```
public static Calendar toCalendar(ZonedDateTime zonedDateTime)
```
    将 ZonedDateTime 按时区转换为 Calendar
    
    Parameters:
    
    zonedDateTime - 表示特定时区的日期和时间
    
    Returns:
    
    Java 1.8 以前的日历
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(Date date)
```
    将 Date 按默认时区转换为 LocalDateTime
    
    Parameters:
    
    date - Java 1.8 以前的日期
    
    Returns:
    
    表示与时区无关的日期和时间信息，不直接对应时刻，需要通过时区转换
  - toLocalDate
```
public static LocalDate toLocalDate(Date date)
```
    将 Date 按默认时区转换为 LocalDate
    
    Parameters:
    
    date - Java 1.8 以前的日期
    
    Returns:
    
    表示与时区无关的日期，只有日期信息，没有时间信息
  - toZonedDateTime
```
public static ZonedDateTime toZonedDateTime(Calendar calendar)
```
    将 ZonedDateTime 按时区转换为 Calendar
    
    Parameters:
    
    calendar - Java 1.8 以前的日历
    
    Returns:
    
    表示特定时区的日期和时间
  - print2DateTimeCN
```
public static String print2DateTimeCN(Date date)
```
    转换日期为：yyyy-MM-dd HH:mm:ss
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyy-MM-dd HH:mm:ss”字符串
  - print2DateTimeCN
```
public static String print2DateTimeCN(LocalDateTime date)
```
    转换日期为：yyyy-MM-dd HH:mm:ss
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyy-MM-dd HH:mm:ss”字符串
  - parse2DateTimeCN
```
public static Date parse2DateTimeCN(String date)
```
    将字符串日期：yyyy-MM-dd HH:mm:ss 转换为日期
    
    Parameters:
    
    date - “yyyy-MM-dd HH:mm:ss”字符串
    
    Returns:
    
    日期
  - parseToDateTimeCN
```
public static LocalDateTime parseToDateTimeCN(String date)
```
    将字符串日期：yyyy-MM-dd HH:mm:ss 转换为日期
    
    Parameters:
    
    date - “yyyy-MM-dd HH:mm:ss”字符串
    
    Returns:
    
    日期
  - print2Date
```
public static String print2Date(Date date)
```
    转换日期为：yyyy-MM-dd
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyy-MM-dd”字符串
  - print2Date
```
public static String print2Date(LocalDateTime date)
```
    转换日期为：yyyy-MM-dd
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyy-MM-dd”字符串
  - parse2Date
```
public static Date parse2Date(String date)
```
    将字符串日期：yyyy-MM-dd 转换为日期
    
    Parameters:
    
    date - “yyyy-MM-dd”字符串
    
    Returns:
    
    日期
  - parseToDate
```
public static LocalDate parseToDate(String date)
```
    将字符串日期：yyyy-MM-dd 转换为日期
    
    Parameters:
    
    date - “yyyy-MM-dd”字符串
    
    Returns:
    
    日期
  - print2DateCN
```
public static String print2DateCN(Date date)
```
    转换日期为：yyyy年MM月dd日
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyy年MM月dd日”字符串
  - print2DateCN
```
public static String print2DateCN(LocalDateTime date)
```
    转换日期为：yyyy年MM月dd日
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyy年MM月dd日”字符串
  - parse2DateCN
```
public static Date parse2DateCN(String date)
```
    将字符串日期：yyyy年MM月dd日转换为日期
    
    Parameters:
    
    date - “yyyy年MM月dd日”字符串
    
    Returns:
    
    日期
  - parseToDateCN
```
public static LocalDate parseToDateCN(String date)
```
    将字符串日期：yyyy年MM月dd日转换为日期
    
    Parameters:
    
    date - “yyyy年MM月dd日”字符串
    
    Returns:
    
    日期
  - print2DateTimeEN
```
public static String print2DateTimeEN(Date date)
```
    转换日期为：yyyyMMddHHmmss
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyyMMddHHmmss”字符串
  - print2DateTimeEN
```
public static String print2DateTimeEN(LocalDateTime date)
```
    转换日期为：yyyyMMddHHmmss
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyyMMddHHmmss”字符串
  - parse2DateTimeEN
```
public static Date parse2DateTimeEN(String date)
```
    将字符串日期：yyyyMMddHHmmss 转换为日期
    
    Parameters:
    
    date - “yyyyMMddHHmmss”字符串
    
    Returns:
    
    日期
  - parseToDateTimeEN
```
public static LocalDateTime parseToDateTimeEN(String date)
```
    将字符串日期：yyyyMMddHHmmss 转换为日期
    
    Parameters:
    
    date - “yyyyMMddHHmmss”字符串
    
    Returns:
    
    日期
  - print2DateEN
```
public static String print2DateEN(Date date)
```
    转换日期为：yyyyMMdd
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyyMMdd”字符串
  - print2DateEN
```
public static String print2DateEN(LocalDate date)
```
    转换日期为：yyyyMMdd
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyyMMdd”字符串
  - print2DateEN
```
public static String print2DateEN(LocalDateTime date)
```
    转换日期为：yyyyMMdd
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyyMMdd”字符串
  - parse2DateEN
```
public static Date parse2DateEN(String date)
```
    将字符串日期：yyyyMMdd 转换为日期
    
    Parameters:
    
    date - “yyyyMMdd”字符串
    
    Returns:
    
    日期
  - parseToDateEN
```
public static LocalDateTime parseToDateEN(String date)
```
    将字符串日期：yyyyMMdd 转换为日期
    
    Parameters:
    
    date - “yyyyMMdd”字符串
    
    Returns:
    
    日期
  - print2YearMonth
```
public static String print2YearMonth(Date date)
```
    转换日期为：yyyyMM
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyyMM”字符串
  - print2YearMonth
```
public static String print2YearMonth(LocalDate date)
```
    转换日期为：yyyyMM
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyyMM”字符串
  - print2YearMonth
```
public static String print2YearMonth(LocalDateTime date)
```
    转换日期为：yyyyMM
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“yyyyMM”字符串
  - parse2YearMonth
```
public static Date parse2YearMonth(String date)
```
    将字符串日期：yyyyMM 转换为日期（返回当月的1号）
    
    Parameters:
    
    date - “yyyyMM”字符串
    
    Returns:
    
    日期
  - parseToYearMonth
```
public static LocalDateTime parseToYearMonth(String date)
```
    将字符串日期：yyyyMM 转换为日期（返回当月的1号）
    
    Parameters:
    
    date - “yyyyMM”字符串
    
    Returns:
    
    日期
  - print2Time
```
public static String print2Time(Date date)
```
    转换日期为：HH:mm:ss
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“HH:mm:ss”字符串
  - print2Time
```
public static String print2Time(LocalDateTime date)
```
    转换日期为：HH:mm:ss
    
    Parameters:
    
    date - 待转换的日期
    
    Returns:
    
    格式化后的“HH:mm:ss”字符串
  - checkDateTimeOverlap
```
public static boolean checkDateTimeOverlap(Date srcEffectiveTime,
                                           Date srcExpiryTime,
                                           Date targetEffectiveTime,
                                           Date targetExpiryTime)
```
    校验时间区间是否有重叠，比较"源的时间区间"是否在"目标的时间区间"内
    
    Parameters:
    
    srcEffectiveTime - 源，生效时间
    
    srcExpiryTime - 源，过期时间
    
    targetEffectiveTime - 目标，生效时间
    
    targetExpiryTime - 目标，过去时间
    
    Returns:
    
    true: 有重叠, false: 没有重叠
  - checkDateTimeOverlap
```
public static boolean checkDateTimeOverlap(LocalDateTime srcEffectiveTime,
                                           LocalDateTime srcExpiryTime,
                                           LocalDateTime targetEffectiveTime,
                                           LocalDateTime targetExpiryTime)
```
    校验时间区间是否有重叠，比较"源的时间区间"是否在"目标的时间区间"内
    
    Parameters:
    
    srcEffectiveTime - 源，生效时间
    
    srcExpiryTime - 源，过期时间
    
    targetEffectiveTime - 目标，生效时间
    
    targetExpiryTime - 目标，过去时间
    
    Returns:
    
    true: 有重叠, false: 没有重叠
  - withTimeAtStartOfDay
```
public static Date withTimeAtStartOfDay(Date date)
```
    获取日期当天的 00:00:00。 Example:
```
 '2017-03-23 16:20:47' -> '2017-03-23 00:00:00.000'
 
```
    Parameters:
    
    date - 日期参数
    
    Returns:
    
    日期当天的 00:00:00.000
  - withTimeAtStartOfDay
```
public static Date withTimeAtStartOfDay(LocalDateTime date)
```
    获取日期当天的 00:00:00。 Example:
```
 '2017-03-23 16:20:47' -> '2017-03-23 00:00:00.000'
 
```
    Parameters:
    
    date - 日期参数
    
    Returns:
    
    日期当天的 00:00:00.000
  - withTimeAtEndOfDay
```
public static Date withTimeAtEndOfDay(Date date)
```
    获取日期当天的 23:59:59.999 Example:
```
 '2017-03-23 16:20:47' -> '2017-03-23 23:59:59.999'
 
```
    Parameters:
    
    date - 日期参数
    
    Returns:
    
    日期当天的 23:59:59.999
  - withTimeAtEndOfDay
```
public static Date withTimeAtEndOfDay(LocalDateTime date)
```
    获取日期当天的 23:59:59.999 Example:
```
 '2017-03-23 16:20:47' -> '2017-03-23 23:59:59.999'
 
```
    Parameters:
    
    date - 日期参数
    
    Returns:
    
    日期当天的 23:59:59.999
  - withTimeAtEndOfDayAndRemoveNano
```
public static Date withTimeAtEndOfDayAndRemoveNano(LocalDateTime date)
```
    获取日期当天的 23:59:59.000 Example:
```
 '2017-03-23 16:20:47' -> '2017-03-23 23:59:59.000'
 
```
    Parameters:
    
    date - 日期参数
    
    Returns:
    
    日期当天的 23:59:59.000
  - withTimeAtEndOfDayAndRemoveNano
```
public static Date withTimeAtEndOfDayAndRemoveNano(Date date)
```
    获取日期当天的 23:59:59.000 Example:
```
 '2017-03-23 16:20:47' -> '2017-03-23 23:59:59.000'
 
```
    Parameters:
    
    date - 日期参数
    
    Returns:
    
    日期当天的 23:59:59.000
  - isSameDay
```
public static boolean isSameDay(Date date1,
                                Date date2)
```
    比较两个日期是否相同，会比较时间部分
    
    Parameters:
    
    date1 - 日期1
    
    date2 - 日期2
    
    Returns:
    
    true: 相同; false: 不相同
  - isSameDay
```
public static boolean isSameDay(LocalDateTime date1,
                                LocalDateTime date2)
```
    比较两个日期是否相同，会比较时间部分
    
    Parameters:
    
    date1 - 日期1
    
    date2 - 日期2
    
    Returns:
    
    true: 相同; false: 不相同

Class DateTimeFormatUtils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

YYYY_MM_DD_HH_MM_SS

YYYY_MM_DD

YYYY_MM_DD_CN

YYYYMMDDHHMMSS

YYYYMMDD

YYYYMM

HH_MM_SS

Constructor Detail

DateTimeFormatUtils

Method Detail

toDate

toDate

toCalendar

toCalendar

toCalendar

toLocalDateTime

toLocalDate

toZonedDateTime

print2DateTimeCN

print2DateTimeCN

parse2DateTimeCN

parseToDateTimeCN

print2Date

print2Date

parse2Date

parseToDate

print2DateCN

print2DateCN

parse2DateCN

parseToDateCN

print2DateTimeEN

print2DateTimeEN

parse2DateTimeEN

parseToDateTimeEN

print2DateEN

print2DateEN

print2DateEN

parse2DateEN

parseToDateEN

print2YearMonth

print2YearMonth

print2YearMonth

parse2YearMonth

parseToYearMonth

print2Time

print2Time

checkDateTimeOverlap

checkDateTimeOverlap

withTimeAtStartOfDay

withTimeAtStartOfDay

withTimeAtEndOfDay

withTimeAtEndOfDay

withTimeAtEndOfDayAndRemoveNano

withTimeAtEndOfDayAndRemoveNano

isSameDay

isSameDay