DateTimeTools (Plusone Commons 1.1.0-RC1 API)

java.lang.Object
- xyz.zhouxy.plusone.commons.util.DateTimeTools

public class DateTimeTools
extends Object

日期时间工具类

Author:: ZhouXY108

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static LocalDate`	`endDateOfYear(int year)` 获取指定年份的结束日期
`static YearQuarter`	`getQuarter(Calendar date)` 获取指定日期所在季度
`static YearQuarter`	`getQuarter(Date date)` Deprecated. 此方法使用系统默认时区，不建议使用。请使用 `#of(Date,ZoneId)`、`#of(Date,TimeZone)` 或其它工厂方法
`static YearQuarter`	`getQuarter(Date date, TimeZone timeZone)` 根据指定日期，判断日期所在的年份与季度，创建 `YearQuarter` 实例
`static YearQuarter`	`getQuarter(Date date, ZoneId timeZone)` 根据指定日期，判断日期所在的年份与季度，创建 `YearQuarter` 实例
`static YearQuarter`	`getQuarter(int year, Month month)` 获取指定年月所在季度
`static YearQuarter`	`getQuarter(LocalDate date)` 获取指定日期所在季度
`static Quarter`	`getQuarter(Month month)` 获取指定月份所在季度
`static YearQuarter`	`getQuarter(YearMonth yearMonth)` 获取指定年月所在季度
`static boolean`	`isFuture(Calendar calendar)` 判断指定日期时间是否在将来
`static boolean`	`isFuture(Date date)` 判断指定日期时间是否在将来
`static boolean`	`isFuture(Instant instant)` 判断指定时刻是否在将来
`static boolean`	`isFuture(LocalDate date)` 判断指定日期是否在将来
`static boolean`	`isFuture(LocalDateTime dateTime)` 判断指定日期时间是否在将来
`static boolean`	`isFuture(long timeMillis)` 判断指定时间戳是否在将来
`static boolean`	`isFuture(ZonedDateTime dateTime)` 判断指定日期时间是否在将来
`static boolean`	`isLeapYear(int year)` 判断指定年份是否为闰年
`static boolean`	`isPast(Calendar calendar)` 判断指定日期时间是否在过去
`static boolean`	`isPast(Date date)` 判断指定日期时间是否在过去
`static boolean`	`isPast(Instant instant)` 判断指定时刻是否在过去
`static boolean`	`isPast(LocalDate date)` 判断指定日期是否在过去
`static boolean`	`isPast(LocalDateTime dateTime)` 判断指定日期时间是否在过去
`static boolean`	`isPast(long timeMillis)` 判断指定时间戳是否在过去
`static boolean`	`isPast(ZonedDateTime dateTime)` 判断指定日期时间是否在过去
`static LocalDate`	`startDateOfYear(int year)` 获取指定年份的开始日期
`static LocalDateTime`	`startOfNextDate(LocalDate date)` 获取指定日期的第二天的开始时间
`static ZonedDateTime`	`startOfNextDate(LocalDate date, ZoneId zone)` 获取指定日期的第二天的开始时间
`static Date`	`toDate(Calendar calendar)` 将 `Calendar` 对象转换为 `Date` 对象
`static Date`	`toDate(Instant instant)` 将 `Instant` 对象转换为 `Date` 对象
`static Date`	`toDate(LocalDate localDate, LocalTime localTime, ZoneId zone)` 使用指定时区，将 `LocalDate` 和 `LocalTime` 对象转换为 `Date` 对象
`static Date`	`toDate(LocalDateTime localDateTime, ZoneId zone)` 使用指定时区，将 `LocalDateTime` 对象转换为 `Date` 对象
`static Date`	`toDate(long timeMillis)` 将时间戳转换为 `Date` 对象
`static Date`	`toDate(ZonedDateTime zonedDateTime)` 将 `ZonedDateTime` 对象转换为 `Date` 对象
`static com.google.common.collect.Range<LocalDateTime>`	`toDateTimeRange(LocalDate date)` 获取指定日期的时间范围
`static com.google.common.collect.Range<ZonedDateTime>`	`toDateTimeRange(LocalDate date, ZoneId zone)` 获取指定日期的时间范围
`static com.google.common.collect.Range<LocalDateTime>`	`toDateTimeRange(com.google.common.collect.Range<LocalDate> dateRange)` 将指定日期范围转为日期时间范围
`static com.google.common.collect.Range<ZonedDateTime>`	`toDateTimeRange(com.google.common.collect.Range<LocalDate> dateRange, ZoneId zone)` 将指定日期范围转为日期时间范围
`static Instant`	`toInstant(Calendar calendar)` 将 `Calendar` 对象转换为 `Instant` 对象
`static Instant`	`toInstant(Date date)` 将 `Date` 对象转换为 `Instant` 对象
`static Instant`	`toInstant(LocalDateTime localDateTime, ZoneId zone)` 使用指定时区，将 `LocalDateTime` 对象转换为 `Instant` 对象
`static Instant`	`toInstant(long timeMillis)` 将时间戳转换为 `Instant` 对象
`static Instant`	`toInstant(ZonedDateTime zonedDateTime)` 将 `ZonedDateTime` 对象转换为 `Instant` 对象
`static LocalDateTime`	`toLocalDateTime(Calendar calendar, TimeZone zone)` 获取 `Calendar` 所表示的时间戳，在指定时区的地区时间。
`static LocalDateTime`	`toLocalDateTime(Calendar calendar, ZoneId zone)` 获取 `Calendar` 所表示的时间戳，在指定时区的地区时间。
`static LocalDateTime`	`toLocalDateTime(Date dateTime, TimeZone timeZone)` 获取 `Date` 所表示的时间戳，在指定时区的地区时间。
`static LocalDateTime`	`toLocalDateTime(Date dateTime, ZoneId zone)` 获取 `Date` 所表示的时间戳，在指定时区的地区时间。
`static LocalDateTime`	`toLocalDateTime(long timeMillis, ZoneId zone)` 获取时间戳在指定时区的地区时间。
`static LocalDateTime`	`toLocalDateTime(ZonedDateTime zonedDateTime, ZoneId zone)` 获取 `ZonedDateTime` 所表示的时间戳，在指定时区的地区时间。
`static String`	`toMonthStringM(int monthValue)`
`static String`	`toMonthStringM(Month month)`
`static String`	`toMonthStringMM(int monthValue)`
`static String`	`toMonthStringMM(Month month)`
`static String`	`toYearString(int year)`
`static String`	`toYearString(Year year)`
`static ZonedDateTime`	`toZonedDateTime(Calendar calendar)` 使用 `calendar` 对象的时区信息，将 `Calendar` 对象转换为 `ZonedDateTime` 对象。
`static ZonedDateTime`	`toZonedDateTime(Calendar calendar, TimeZone zone)` 使用指定的时区，将 `Calendar` 对象转换为 `ZonedDateTime` 对象。
`static ZonedDateTime`	`toZonedDateTime(Calendar calendar, ZoneId zone)` 使用指定的时区，将 `Calendar` 对象转换为 `ZonedDateTime` 对象。
`static ZonedDateTime`	`toZonedDateTime(Date dateTime, TimeZone timeZone)` 获取 `Date` 所表示的时间戳，在指定时区的地区时间。
`static ZonedDateTime`	`toZonedDateTime(Date dateTime, ZoneId zone)` 获取 `Date` 所表示的时间戳，在指定时区的地区时间。
`static ZonedDateTime`	`toZonedDateTime(LocalDateTime localDateTime, ZoneId zone)` 创建带时区的地区时间
`static ZonedDateTime`	`toZonedDateTime(long timeMillis, ZoneId zone)` 获取时间戳在指定时区的地区时间。

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

- Method Detail
  - toYearString
```
public static String toYearString(int year)
```
  - toYearString
```
public static String toYearString(Year year)
```
  - toMonthStringM
```
public static String toMonthStringM(int monthValue)
```
  - toMonthStringMM
```
public static String toMonthStringMM(int monthValue)
```
  - toMonthStringM
```
public static String toMonthStringM(Month month)
```
  - toMonthStringMM
```
public static String toMonthStringMM(Month month)
```
  - toDate
```
public static Date toDate(long timeMillis)
```
    将时间戳转换为 Date 对象
    
    Parameters:
    
    timeMillis - 时间戳
    
    Returns:
    
    Date 对象
  - toDate
```
public static Date toDate(Calendar calendar)
```
    将 Calendar 对象转换为 Date 对象
    
    Parameters:
    
    calendar - Calendar 对象
    
    Returns:
    
    Date 对象
  - toDate
```
public static Date toDate(Instant instant)
```
    将 Instant 对象转换为 Date 对象
    
    Parameters:
    
    instant - Instant 对象
    
    Returns:
    
    Date 对象
  - toDate
```
public static Date toDate(ZonedDateTime zonedDateTime)
```
    将 ZonedDateTime 对象转换为 Date 对象
    
    Parameters:
    
    zonedDateTime - ZonedDateTime 对象
    
    Returns:
    
    Date 对象
  - toDate
```
public static Date toDate(LocalDateTime localDateTime,
                          ZoneId zone)
```
    使用指定时区，将 LocalDateTime 对象转换为 Date 对象
    
    Parameters:
    
    localDateTime - LocalDateTime 对象
    
    zone - 时区
    
    Returns:
    
    Date 对象
  - toDate
```
public static Date toDate(LocalDate localDate,
                          LocalTime localTime,
                          ZoneId zone)
```
    使用指定时区，将 LocalDate 和 LocalTime 对象转换为 Date 对象
    
    Parameters:
    
    localDate - LocalDate 对象
    
    localTime - LocalTime 对象
    
    zone - 时区
    
    Returns:
    
    Date 对象
  - toInstant
```
public static Instant toInstant(long timeMillis)
```
    将时间戳转换为 Instant 对象
    
    Parameters:
    
    timeMillis - 时间戳
    
    Returns:
    
    Instant 对象
  - toInstant
```
public static Instant toInstant(Date date)
```
    将 Date 对象转换为 Instant 对象
    
    Parameters:
    
    date - Date 对象
    
    Returns:
    
    Instant 对象
  - toInstant
```
public static Instant toInstant(Calendar calendar)
```
    将 Calendar 对象转换为 Instant 对象
    
    Parameters:
    
    calendar - Calendar 对象
    
    Returns:
    
    Instant 对象
  - toInstant
```
public static Instant toInstant(ZonedDateTime zonedDateTime)
```
    将 ZonedDateTime 对象转换为 Instant 对象
    
    Parameters:
    
    zonedDateTime - ZonedDateTime 对象
    
    Returns:
    
    Instant 对象
  - toInstant
```
public static Instant toInstant(LocalDateTime localDateTime,
                                ZoneId zone)
```
    使用指定时区，将 LocalDateTime 对象转换为 Instant 对象
    
    Parameters:
    
    localDateTime - LocalDateTime 对象
    
    zone - 时区
    
    Returns:
    
    Instant 对象
  - toZonedDateTime
```
public static ZonedDateTime toZonedDateTime(long timeMillis,
                                            ZoneId zone)
```
    获取时间戳在指定时区的地区时间。
    传入不同 ZoneId，获取到的 ZonedDateTime 对象实际上还是同一时间戳，只是不同时区的表示。
    
    Parameters:
    
    timeMillis - 时间戳
    
    zone - 时区
    
    Returns:
    
    带时区信息的地区时间
  - toZonedDateTime
```
public static ZonedDateTime toZonedDateTime(Date dateTime,
                                            ZoneId zone)
```
    获取 Date 所表示的时间戳，在指定时区的地区时间。
    传入不同 ZoneId，获取到的 ZonedDateTime 对象实际上还是同一时间戳，只是不同时区的表示。
    
    Parameters:
    
    dateTime - Date 对象
    
    zone - 时区
    
    Returns:
    
    带时区信息的地区时间
  - toZonedDateTime
```
public static ZonedDateTime toZonedDateTime(Date dateTime,
                                            TimeZone timeZone)
```
    获取 Date 所表示的时间戳，在指定时区的地区时间。
    传入不同 ZoneId，获取到的 ZonedDateTime 对象实际上表示的还是还是同一时间戳的时间，只是不同时区的表示。
    
    Parameters:
    
    dateTime - Date 对象
    
    timeZone - 时区
    
    Returns:
    
    带时区信息的地区时间
  - toZonedDateTime
```
public static ZonedDateTime toZonedDateTime(Calendar calendar)
```
    使用 calendar 对象的时区信息，将 Calendar 对象转换为 ZonedDateTime 对象。
    
    Parameters:
    
    calendar{@link - Calendar} 对象
    
    Returns:
    
    ZonedDateTime 对象
  - toZonedDateTime
```
public static ZonedDateTime toZonedDateTime(Calendar calendar,
                                            ZoneId zone)
```
    使用指定的时区，将 Calendar 对象转换为 ZonedDateTime 对象。
    
    Parameters:
    
    calendar - Calendar 对象
    
    zone - 时区
    
    Returns:
    
    ZonedDateTime 对象
  - toZonedDateTime
```
public static ZonedDateTime toZonedDateTime(Calendar calendar,
                                            TimeZone zone)
```
    使用指定的时区，将 Calendar 对象转换为 ZonedDateTime 对象。
    
    Parameters:
    
    calendar - Calendar 对象
    
    zone - 时区
    
    Returns:
    
    ZonedDateTime 对象
  - toZonedDateTime
```
public static ZonedDateTime toZonedDateTime(LocalDateTime localDateTime,
                                            ZoneId zone)
```
    创建带时区的地区时间
    
    Parameters:
    
    localDateTime - 地区时间
    
    zone - 时区
    
    Returns:
    
    带时区的地区时间
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(long timeMillis,
                                            ZoneId zone)
```
    获取时间戳在指定时区的地区时间。
    
    Parameters:
    
    timeMillis - 时间戳
    
    zone - 时区
    
    Returns:
    
    地区时间
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(Date dateTime,
                                            ZoneId zone)
```
    获取 Date 所表示的时间戳，在指定时区的地区时间。
    
    Parameters:
    
    dateTime - Date 对象
    
    zone - 时区
    
    Returns:
    
    地区时间
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(Date dateTime,
                                            TimeZone timeZone)
```
    获取 Date 所表示的时间戳，在指定时区的地区时间。
    
    Parameters:
    
    dateTime - Date 对象
    
    timeZone - 时区
    
    Returns:
    
    地区时间
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(Calendar calendar,
                                            ZoneId zone)
```
    获取 Calendar 所表示的时间戳，在指定时区的地区时间。
    
    Parameters:
    
    calendar - Calendar 对象
    
    zone - 时区
    
    Returns:
    
    地区时间
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(Calendar calendar,
                                            TimeZone zone)
```
    获取 Calendar 所表示的时间戳，在指定时区的地区时间。
    
    Parameters:
    
    calendar - Calendar 对象
    
    zone - 时区
    
    Returns:
    
    地区时间
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(ZonedDateTime zonedDateTime,
                                            ZoneId zone)
```
    获取 ZonedDateTime 所表示的时间戳，在指定时区的地区时间。
    
    Parameters:
    
    zonedDateTime - ZonedDateTime 对象
    
    zone - 时区
    
    Returns:
    
    地区时间
  - getQuarter
```
@Deprecated
public static YearQuarter getQuarter(Date date)
```
    Deprecated. 此方法使用系统默认时区，不建议使用。请使用 #of(Date,ZoneId)、#of(Date,TimeZone) 或其它工厂方法
    
    获取指定日期所在季度
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    日期所在的季度
  - getQuarter
```
public static YearQuarter getQuarter(Date date,
                                     ZoneId timeZone)
```
    根据指定日期，判断日期所在的年份与季度，创建 YearQuarter 实例
    
    Parameters:
    
    date - 日期
    
    timeZone - 时区
    
    Returns:
    
    YearQuarter 实例
  - getQuarter
```
public static YearQuarter getQuarter(Date date,
                                     TimeZone timeZone)
```
    根据指定日期，判断日期所在的年份与季度，创建 YearQuarter 实例
    
    Parameters:
    
    date - 日期
    
    timeZone - 时区
    
    Returns:
    
    YearQuarter 实例
  - getQuarter
```
public static YearQuarter getQuarter(Calendar date)
```
    获取指定日期所在季度
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    日期所在的季度
  - getQuarter
```
public static Quarter getQuarter(Month month)
```
    获取指定月份所在季度
    
    Parameters:
    
    month - 月份
    
    Returns:
    
    季度
  - getQuarter
```
public static YearQuarter getQuarter(int year,
                                     Month month)
```
    获取指定年月所在季度
    
    Parameters:
    
    year - 年
    
    month - 月
    
    Returns:
    
    季度
  - getQuarter
```
public static YearQuarter getQuarter(YearMonth yearMonth)
```
    获取指定年月所在季度
    
    Parameters:
    
    yearMonth - 年月
    
    Returns:
    
    季度
  - getQuarter
```
public static YearQuarter getQuarter(LocalDate date)
```
    获取指定日期所在季度
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    日期所在的季度
  - startDateOfYear
```
public static LocalDate startDateOfYear(int year)
```
    获取指定年份的开始日期
    
    Parameters:
    
    year - 年份
    
    Returns:
    
    指定年份的开始日期
  - endDateOfYear
```
public static LocalDate endDateOfYear(int year)
```
    获取指定年份的结束日期
    
    Parameters:
    
    year - 年份
    
    Returns:
    
    指定年份的结束日期
  - startOfNextDate
```
public static LocalDateTime startOfNextDate(LocalDate date)
```
    获取指定日期的第二天的开始时间
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    指定日期的第二天的开始时间
  - startOfNextDate
```
public static ZonedDateTime startOfNextDate(LocalDate date,
                                            ZoneId zone)
```
    获取指定日期的第二天的开始时间
    
    Parameters:
    
    date - 日期
    
    zone - 时区
    
    Returns:
    
    指定日期的第二天的开始时间
  - isFuture
```
public static boolean isFuture(Date date)
```
    判断指定日期时间是否在将来
    
    Parameters:
    
    date - 日期时间
    
    Returns:
    
    指定日期时间是否在将来
  - isFuture
```
public static boolean isFuture(Calendar calendar)
```
    判断指定日期时间是否在将来
    
    Parameters:
    
    calendar - 日期时间
    
    Returns:
    
    指定日期时间是否在将来
  - isFuture
```
public static boolean isFuture(Instant instant)
```
    判断指定时刻是否在将来
    
    Parameters:
    
    instant - 时刻
    
    Returns:
    
    指定时刻是否在将来
  - isFuture
```
public static boolean isFuture(long timeMillis)
```
    判断指定时间戳是否在将来
    
    Parameters:
    
    timeMillis - 时间戳
    
    Returns:
    
    指定时间戳是否在将来
  - isFuture
```
public static boolean isFuture(LocalDate date)
```
    判断指定日期是否在将来
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    指定日期是否在将来
  - isFuture
```
public static boolean isFuture(LocalDateTime dateTime)
```
    判断指定日期时间是否在将来
    
    Parameters:
    
    dateTime - 日期时间
    
    Returns:
    
    指定日期时间是否在将来
  - isFuture
```
public static boolean isFuture(ZonedDateTime dateTime)
```
    判断指定日期时间是否在将来
    
    Parameters:
    
    dateTime - 日期时间
    
    Returns:
    
    指定日期时间是否在将来
  - isPast
```
public static boolean isPast(Date date)
```
    判断指定日期时间是否在过去
    
    Parameters:
    
    date - 日期时间
    
    Returns:
    
    指定日期时间是否在过去
  - isPast
```
public static boolean isPast(Calendar calendar)
```
    判断指定日期时间是否在过去
    
    Parameters:
    
    calendar - 日期时间
    
    Returns:
    
    指定日期时间是否在过去
  - isPast
```
public static boolean isPast(Instant instant)
```
    判断指定时刻是否在过去
    
    Parameters:
    
    instant - 时刻
    
    Returns:
    
    指定时刻是否在过去
  - isPast
```
public static boolean isPast(long timeMillis)
```
    判断指定时间戳是否在过去
    
    Parameters:
    
    timeMillis - 时间戳
    
    Returns:
    
    指定时间戳是否在过去
  - isPast
```
public static boolean isPast(LocalDate date)
```
    判断指定日期是否在过去
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    指定日期是否在过去
  - isPast
```
public static boolean isPast(LocalDateTime dateTime)
```
    判断指定日期时间是否在过去
    
    Parameters:
    
    dateTime - 日期时间
    
    Returns:
    
    指定日期时间是否在过去
  - isPast
```
public static boolean isPast(ZonedDateTime dateTime)
```
    判断指定日期时间是否在过去
    
    Parameters:
    
    dateTime - 日期时间
    
    Returns:
    
    指定日期时间是否在过去
  - toDateTimeRange
```
public static com.google.common.collect.Range<LocalDateTime> toDateTimeRange(LocalDate date)
```
    获取指定日期的时间范围
    
    Parameters:
    
    date - 日期
    
    Returns:
    
    指定日期的时间范围
  - toDateTimeRange
```
public static com.google.common.collect.Range<ZonedDateTime> toDateTimeRange(LocalDate date,
                                                                             ZoneId zone)
```
    获取指定日期的时间范围
    
    Parameters:
    
    date - 日期
    
    zone - 时区
    
    Returns:
    
    指定日期的时间范围
  - toDateTimeRange
```
public static com.google.common.collect.Range<LocalDateTime> toDateTimeRange(com.google.common.collect.Range<LocalDate> dateRange)
```
    将指定日期范围转为日期时间范围
    
    Parameters:
    
    dateRange - 日期范围
    
    Returns:
    
    对应的日期时间范围
  - toDateTimeRange
```
public static com.google.common.collect.Range<ZonedDateTime> toDateTimeRange(com.google.common.collect.Range<LocalDate> dateRange,
                                                                             ZoneId zone)
```
    将指定日期范围转为日期时间范围
    
    Parameters:
    
    dateRange - 日期范围
    
    Returns:
    
    对应的日期时间范围
  - isLeapYear
```
public static boolean isLeapYear(int year)
```
    判断指定年份是否为闰年
    
    Parameters:
    
    year - 年份
    
    Returns:
    
    指定年份是否为闰年

Class DateTimeTools

Method Summary

Methods inherited from class java.lang.Object

Method Detail

toYearString

toYearString

toMonthStringM

toMonthStringMM

toMonthStringM

toMonthStringMM

toDate

toDate

toDate

toDate

toDate

toDate

toInstant

toInstant

toInstant

toInstant

toInstant

toZonedDateTime

toZonedDateTime

toZonedDateTime

toZonedDateTime

toZonedDateTime

toZonedDateTime

toZonedDateTime

toLocalDateTime

toLocalDateTime

toLocalDateTime

toLocalDateTime

toLocalDateTime

toLocalDateTime

getQuarter

getQuarter

getQuarter

getQuarter

getQuarter

getQuarter

getQuarter

getQuarter

startDateOfYear

endDateOfYear

startOfNextDate

startOfNextDate

isFuture

isFuture

isFuture

isFuture

isFuture

isFuture

isFuture

isPast

isPast

isPast

isPast

isPast

isPast

isPast

toDateTimeRange

toDateTimeRange

toDateTimeRange

toDateTimeRange

isLeapYear