DateTime (Falcon: A common library for Java 0.4.1 API)

java.lang.Object
- com.iofairy.falcon.time.DateTime<T>

类型参数:

T - The type of DateTime's value

所有已实现的接口:

Serializable, Comparable<DateTime<?>>, Temporal, TemporalAccessor
```
public class DateTime<T>
extends Object
implements Temporal, Comparable<DateTime<?>>, Serializable
```
The DateTime class wraps a value of the Date or Calendar or Instant or LocalDateTime or OffsetDateTime or ZonedDateTime type.

从以下版本开始:

0.3.0

另请参阅:

序列化表格

Implementation Requirements:

This class is immutable and thread-safe.

字段概要

字段
限定符和类型	字段	说明
`private T`	`dateTime`	如果 `dateTime` 是 `Instant` 或 `LocalDateTime` 类型，所有的计算均选择当前默认时区 `TZ.DEFAULT_ZONE` 进行计算。
`private static String`	`DT_PARSE_ERROR_MSG_TPL`	Date time parse error massage template
`private static List<String>`	`EXCLUDED_CLASS_NAMES`	excluded classes
`private Instant`	`instant`	An instantaneous point on the time-line.
`private LocalDateTime`	`localDateTime`	The local date-time.
`private ZoneOffset`	`offset`	时区偏移量。
`private OffsetDateTime`	`offsetDateTime`	The date-time with an offset
`private static long`	`serialVersionUID`
`private static List<Class<?>>`	`SUPPORTED_DATETIME`	Supported date time
`private static String`	`SUPPORTED_DATETIME_STRING`	Supported date time string
`private ZoneId`	`zone`	时区。
`private ZonedDateTime`	`zonedDateTime`	The date-time with a time-zone

构造器概要

构造器
限定符构造器说明

DateTime(T dateTime)

private DateTime(T dateTime, boolean checkValue)

构造器
限定符	构造器	说明
	`DateTime(T dateTime)`
`private`	`DateTime(T dateTime, boolean checkValue)`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`List<DateTime<T>>`	`allDaysInThisWeek()`	获取当前日期所在周的所有7天的日期（默认每周的第一天为星期一）
`List<DateTime<T>>`	`allDaysInThisWeek(DayOfWeek firstDayOfWeek)`	获取当前日期所在周的所有7天的日期
`int`	`compareTo(DateTime<?> otherDT)`
`private static com.iofairy.tuple.Tuple2<CharSequence,String>`	`compatibleFormatter(CharSequence text, String dtPattern)`	The date time format is compatible with `yyyyMMddHHmmssSSS`. NOTE: Java 8 bug: DateTimeFormatter fails on parsing "yyyyMMddHHmmssSSS"
`List<T>`	`datesByShift(int shiftTimes, int amountUnit, ChronoUnit chronoUnit, boolean includeCurrentTime)`	从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
`List<T>`	`datesByShift(int shiftTimes, ChronoUnit chronoUnit)`	从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
`List<T>`	`datesByShift(int shiftTimes, ChronoUnit chronoUnit, boolean includeCurrentTime)`	从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
`List<T>`	`datesFromRange(DateTime<?> toDateTime, int amountUnit, ChronoUnit chronoUnit, IntervalType intervalType)`	从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
`List<T>`	`datesFromRange(DateTime<?> toDateTime, ChronoUnit chronoUnit)`	从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
`List<T>`	`datesFromRange(DateTime<?> toDateTime, ChronoUnit chronoUnit, IntervalType intervalType)`	从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
`int`	`daysOfMonth()`	获取某个月的总天数
`String`	`dtDetail()`	详细的 toString
`DateTime<T>`	`dtInThisWeek(DayOfWeek dayOfWeek)`	获取当前日期所在周的任意星期几的日期（默认每周的第一天为星期一）
`DateTime<T>`	`dtInThisWeek(DayOfWeek firstDayOfWeek, DayOfWeek dayOfWeek)`	获取当前日期所在周的任意星期几的日期
`boolean`	`equals(Object obj)`
`DateTime<T>`	`fill0(ChronoUnit chronoUnit)`	保留所提供的chronoUnit以及比chronoUnit大的单位的值，填充比 chronoUnit 小的单位的值为 0。
`DateTime<T>`	`fill9(ChronoUnit chronoUnit)`	保留所提供的chronoUnit以及比chronoUnit大的单位的值，填充比 chronoUnit 小的单位的值为所允许的最大值。
`DateTime<T>`	`firstInThisWeek()`	获取当前日期所在周的第一天（默认每周的第一天为星期一）
`DateTime<T>`	`firstInThisWeek(DayOfWeek firstDayOfWeek)`	获取当前日期所在周的第一天
`String`	`format(String dtPattern)`	Formats this date-time using the specified DateTime Pattern
`String`	`format(DateTimeFormatter formatter)`	Formats this date-time using the specified formatter
`(专用程序包) static <T> DateTime<T>`	`from(T dateTime)`
`T`	`get()`	Get the copied `dateTime` value.
`int`	`get(TemporalField field)`
`private T`	`getDateTime(T dt)`
`int`	`getDayOfMonth()`
`DayOfWeek`	`getDayOfWeek()`
`int`	`getDayOfYear()`
`int`	`getHour()`
`Instant`	`getInstant()`
`LocalDateTime`	`getLocalDateTime()`
`long`	`getLong(TemporalField field)`
`int`	`getMicros()`
`int`	`getMillis()`
`int`	`getMinute()`
`Month`	`getMonth()`
`int`	`getMonthValue()`
`int`	`getNano()`
`ZoneOffset`	`getOffset()`
`OffsetDateTime`	`getOffsetDateTime()`
`int`	`getSecond()`
`int`	`getYear()`
`ZoneId`	`getZone()`
`ZonedDateTime`	`getZonedDateTime()`
`boolean`	`in(DateTime<?> startDT, DateTime<?> endDT, IntervalType intervalType)`	判断当前 DateTime 是否在提供的两个 DateTime 之间
`boolean`	`isAfter(DateTime<?> otherDT)`
`boolean`	`isAfterOrEquals(DateTime<?> otherDT)`
`boolean`	`isBefore(DateTime<?> otherDT)`
`boolean`	`isBeforeOrEquals(DateTime<?> otherDT)`
`boolean`	`isSupported(TemporalField field)`
`boolean`	`isSupported(TemporalUnit unit)`
`DateTime<T>`	`lastInThisWeek()`	获取当前日期所在周的最后一天（默认每周的第一天为星期一）
`DateTime<T>`	`lastInThisWeek(DayOfWeek firstDayOfWeek)`	获取当前日期所在周的最后一天
`DateTime<T>`	`minus(long amount, TemporalUnit unit)`	对 DateTime 进行增减操作。
`DateTime<T>`	`minus(TemporalAmount amountToSubtract)`	对 DateTime 进行增减操作。
`DateTime<T>`	`minusDays(long days)`
`DateTime<T>`	`minusHours(long hours)`
`DateTime<T>`	`minusMicros(long micros)`
`DateTime<T>`	`minusMillis(long millis)`
`DateTime<T>`	`minusMinutes(long minutes)`
`DateTime<T>`	`minusMonths(long months)`
`DateTime<T>`	`minusNanos(long nanos)`
`DateTime<T>`	`minusSeconds(long seconds)`
`DateTime<T>`	`minusYears(long years)`
`static DateTime<LocalDateTime>`	`now()`	Get current `LocalDateTime`
`static DateTime<Date>`	`nowDate()`	Get current `Date`
`static DateTime<Instant>`	`nowInstant()`	Get current `Instant`
`static <T> DateTime<T>`	`of(T dateTime)`
`static DateTime<LocalDateTime>`	`parse(CharSequence text)`	Obtains an instance of `DateTime<LocalDateTime>` by intelligently determining the format of a time text.
`static DateTime<LocalDateTime>`	`parse(CharSequence text, String dtPattern)`
`static DateTime<LocalDateTime>`	`parse(CharSequence text, DateTimeFormatter formatter)`	Obtains an instance of `DateTime<LocalDateTime>` from a text string using a specific formatter.
`static DateTime<Date>`	`parseDate(CharSequence text)`	Obtains an instance of `DateTime<Date>` from a text intelligently.
`static DateTime<Date>`	`parseDate(CharSequence text, String dtPattern)`
`static DateTime<Date>`	`parseDate(CharSequence text, String dtPattern, ZoneId zoneId)`
`static DateTime<Date>`	`parseDate(CharSequence text, DateTimeFormatter formatter)`
`static DateTime<Date>`	`parseDate(CharSequence text, DateTimeFormatter formatter, ZoneId zoneId)`	从时间格式串中获取 `DateTime<Date>`
`static DateTime<Date>`	`parseDate(CharSequence text, ZoneId zoneId)`	Obtains an instance of `DateTime<Date>` from a text string using a formatter that is intelligently selected through the system.
`DateTime<T>`	`plus(long amount, TemporalUnit unit)`	对 DateTime 进行增减操作。
`DateTime<T>`	`plus(TemporalAmount amountToAdd)`	对 DateTime 进行增减操作。
`DateTime<T>`	`plusDays(long days)`
`DateTime<T>`	`plusHours(long hours)`
`DateTime<T>`	`plusMicros(long micros)`
`DateTime<T>`	`plusMillis(long millis)`
`DateTime<T>`	`plusMinutes(long minutes)`
`DateTime<T>`	`plusMonths(long months)`
`DateTime<T>`	`plusNanos(long nanos)`
`DateTime<T>`	`plusSeconds(long seconds)`
`DateTime<T>`	`plusYears(long years)`
`DateTime<T>`	`round(ChronoUnit chronoUnit, RoundingDT roundingDT)`	对 DateTime 进行取整
`DateTime<T>`	`roundTime(ChronoUnit chronoUnit, int amountUnit, RoundingDT roundingDT)`	对 DateTime 的时，分，秒进行取整。
`Calendar`	`toCalendar(ZoneId zoneId)`	将 DateTime 转为指定时区的 Calendar。
`(专用程序包) Calendar`	`toCalendar(Calendar calendar, ZonedDateTime zonedDateTime)`	ZonedDateTime 转成 Calendar，且返回的 Calendar 与参数 calendar 相同类型
`Date`	`toDate()`	将 DateTime 转为特定时区的 Date 注： `Date` 是指当前默认时区的时间，所以指定时区没有意义，总是会转换成默认时区。
`Calendar`	`toDefaultCalendar()`	将 DateTime 转为 `TZ.DEFAULT_ZONE` 时区的 `Calendar`
`OffsetDateTime`	`toDefaultOffsetDT()`	将 DateTime 转为 `DateTimes.defaultOffset()` 时区的 `OffsetDateTime`
`ZonedDateTime`	`toDefaultZonedDT()`	将 DateTime 转为 `TZ.DEFAULT_ZONE` 时区的 `ZonedDateTime`
`long`	`toEpochMilli()`
`long`	`toEpochSecond()`
`Instant`	`toInstant()`	将 DateTime 转为 `Instant`。
`LocalDateTime`	`toLocalDateTime()`	将 DateTime 转为 `LocalDateTime`
`OffsetDateTime`	`toOffsetDT(ZoneOffset zoneOffset)`	将 DateTime 转为指定时区的 `OffsetDateTime`
`String`	`toString()`
`Calendar`	`toUTCCalendar()`	将 DateTime 转为 `TZ.UTC` 时区的 `Calendar`
`OffsetDateTime`	`toUTCOffsetDT()`	将 DateTime 转为 `ZoneOffset.UTC` 时区的 `OffsetDateTime`
`ZonedDateTime`	`toUTCZonedDT()`	将 DateTime 转为 `TZ.UTC` 时区的 `ZonedDateTime`
`private com.iofairy.tuple.Tuple2<Instant,ZonedDateTime>`	`toZDTAndInstant()`
`ZonedDateTime`	`toZonedDT(ZoneId zoneId)`	将 DateTime 转为指定时区的 `ZonedDateTime`
`long`	`until(Temporal endExclusive, TemporalUnit unit)`
`DateTime<T>`	`with(TemporalAdjuster adjuster)`
`DateTime<T>`	`with(TemporalField field, long newValue)`
`DateTime<T>`	`withDayOfMonth(int dayOfMonth)`
`DateTime<T>`	`withDayOfYear(int dayOfYear)`
`DateTime<T>`	`withHour(int hour)`
`DateTime<T>`	`withMinute(int minute)`
`DateTime<T>`	`withMonth(int month)`
`DateTime<T>`	`withNano(int nanoOfSecond)`
`DateTime<T>`	`withSecond(int second)`
`DateTime<T>`	`withYear(int year)`

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

从接口继承的方法 java.time.temporal.TemporalAccessor
query, range

- 字段详细资料
  - serialVersionUID
```
private static final long serialVersionUID
```
    另请参阅:
    
    常量字段值
  - dateTime
```
private final T dateTime
```
    如果 dateTime 是 Instant 或 LocalDateTime 类型，所有的计算均选择当前默认时区 TZ.DEFAULT_ZONE 进行计算。
    如若不想使用当前默认时区，请在外部手动将 dateTime 转成 ZonedDateTime 类型之后，再构造 DateTime<T> 对象
  - localDateTime
```
private final LocalDateTime localDateTime
```
    The local date-time.
    当 dateTime 是 Instant 类型时，采用当前默认时区获取 LocalDateTime
  - offset
```
private final ZoneOffset offset
```
    时区偏移量。
    当 dateTime 是 Instant 类型时，时区偏移量采用当前默认时区的偏移量；
    当 dateTime 是 LocalDateTime 类型时，时区偏移量采用当前默认时区的偏移量。
  - zone
```
private final ZoneId zone
```
    时区。
    当 dateTime 是 Instant 类型时，时区采用当前默认时区 TZ.DEFAULT_ZONE；
    当 dateTime 是 LocalDateTime 类型时，时区采用当前默认时区 TZ.DEFAULT_ZONE。
  - instant
```
private final Instant instant
```
    An instantaneous point on the time-line.
  - zonedDateTime
```
private final ZonedDateTime zonedDateTime
```
    The date-time with a time-zone
  - offsetDateTime
```
private final OffsetDateTime offsetDateTime
```
    The date-time with an offset
  - SUPPORTED_DATETIME
```
private static final List<Class<?>> SUPPORTED_DATETIME
```
    Supported date time
  - SUPPORTED_DATETIME_STRING
```
private static final String SUPPORTED_DATETIME_STRING
```
    Supported date time string
  - EXCLUDED_CLASS_NAMES
```
private static final List<String> EXCLUDED_CLASS_NAMES
```
    excluded classes
  - DT_PARSE_ERROR_MSG_TPL
```
private static final String DT_PARSE_ERROR_MSG_TPL
```
    Date time parse error massage template
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - DateTime
```
public DateTime(T dateTime)
```
  - DateTime
```
private DateTime(T dateTime,
                 boolean checkValue)
```
- 方法详细资料
  - of
```
public static <T> DateTime<T> of(T dateTime)
```
  - from
```
static <T> DateTime<T> from(T dateTime)
```
  - getDateTime
```
private T getDateTime(T dt)
```
  - get
```
public T get()
```
    Get the copied dateTime value.
    
    返回:
    
    dateTime
  - now
```
public static DateTime<LocalDateTime> now()
```
    Get current LocalDateTime
    
    返回:
    
    DateTime<LocalDateTime>
    
    从以下版本开始:
    
    0.3.10
  - nowDate
```
public static DateTime<Date> nowDate()
```
    Get current Date
    
    返回:
    
    DateTime<Date>
    
    从以下版本开始:
    
    0.3.10
  - nowInstant
```
public static DateTime<Instant> nowInstant()
```
    Get current Instant
    
    返回:
    
    DateTime<Instant>
    
    从以下版本开始:
    
    0.3.10
  - getLocalDateTime
```
public LocalDateTime getLocalDateTime()
```
  - getOffset
```
public ZoneOffset getOffset()
```
  - getZone
```
public ZoneId getZone()
```
  - getInstant
```
public Instant getInstant()
```
  - getZonedDateTime
```
public ZonedDateTime getZonedDateTime()
```
  - getOffsetDateTime
```
public OffsetDateTime getOffsetDateTime()
```
  - toZDTAndInstant
```
private com.iofairy.tuple.Tuple2<Instant,ZonedDateTime> toZDTAndInstant()
```
  - toUTCZonedDT
```
public ZonedDateTime toUTCZonedDT()
```
    将 DateTime 转为 TZ.UTC 时区的 ZonedDateTime
    
    返回:
    
    ZonedDateTime
  - toDefaultZonedDT
```
public ZonedDateTime toDefaultZonedDT()
```
    将 DateTime 转为 TZ.DEFAULT_ZONE 时区的 ZonedDateTime
    
    返回:
    
    ZonedDateTime
  - toZonedDT
```
public ZonedDateTime toZonedDT(ZoneId zoneId)
```
    将 DateTime 转为指定时区的 ZonedDateTime
    
    参数:
    
    zoneId - zoneId. 当 zoneId为null时，且 dateTime 是 ZonedDateTime 或 OffsetDateTime 或 Calendar 类型时，默认采用dateTime自己的时区；否则，默认采用TZ.DEFAULT_ZONE
    
    返回:
    
    ZonedDateTime
  - toUTCOffsetDT
```
public OffsetDateTime toUTCOffsetDT()
```
    将 DateTime 转为 ZoneOffset.UTC 时区的 OffsetDateTime
    
    返回:
    
    OffsetDateTime
  - toDefaultOffsetDT
```
public OffsetDateTime toDefaultOffsetDT()
```
    将 DateTime 转为 DateTimes.defaultOffset() 时区的 OffsetDateTime
    
    返回:
    
    OffsetDateTime
  - toOffsetDT
```
public OffsetDateTime toOffsetDT(ZoneOffset zoneOffset)
```
    将 DateTime 转为指定时区的 OffsetDateTime
    
    参数:
    
    zoneOffset - zoneOffset. 当 zoneOffset为null时，且 datetime 是 OffsetDateTime 或 ZonedDateTime 或 Calendar 类型时，默认采用datetime自己的时区偏移；否则，默认采用DateTimes.defaultOffset()时区偏移
    
    返回:
    
    OffsetDateTime
  - toUTCCalendar
```
public Calendar toUTCCalendar()
```
    将 DateTime 转为 TZ.UTC 时区的 Calendar
    
    返回:
    
    Calendar
  - toDefaultCalendar
```
public Calendar toDefaultCalendar()
```
    将 DateTime 转为 TZ.DEFAULT_ZONE 时区的 Calendar
    
    返回:
    
    Calendar
  - toCalendar
```
public Calendar toCalendar(ZoneId zoneId)
```
    将 DateTime 转为指定时区的 Calendar。
    
    参数:
    
    zoneId - 时区。当 zoneId为null时，且 dateTime 是 ZonedDateTime 或 OffsetDateTime 或 Calendar 类型时，默认采用dateTime自己的时区；否则，默认采用TZ.DEFAULT_ZONE
    
    返回:
    
    Calendar
  - toCalendar
```
Calendar toCalendar(Calendar calendar,
                    ZonedDateTime zonedDateTime)
```
    ZonedDateTime 转成 Calendar，且返回的 Calendar 与参数 calendar 相同类型
    
    参数:
    
    calendar - calendar，用于指示返回的 Calendar 的类型
    
    zonedDateTime - zonedDateTime
    
    返回:
    
    返回与参数 calendar 相同类型的 Calendar
  - toLocalDateTime
```
public LocalDateTime toLocalDateTime()
```
    将 DateTime 转为 LocalDateTime
    
    返回:
    
    LocalDateTime
  - toDate
```
public Date toDate()
```
    将 DateTime 转为特定时区的 Date
    注：
    Date 是指当前默认时区的时间，所以指定时区没有意义，总是会转换成默认时区。
    
    返回:
    
    Date
  - toInstant
```
public Instant toInstant()
```
    将 DateTime 转为 Instant。
    LocalDateTime 转为 Instant 时，以 默认时区 的 LocalDateTime 转为 Instant。
    
    返回:
    
    Instant
  - plus
```
public DateTime<T> plus(long amount,
                        TemporalUnit unit)
```
    对 DateTime 进行增减操作。
    注： Instant 类型的时间会先转成 TZ.DEFAULT_ZONE 时区的 ZonedDateTime 进行增减。
    
    指定者:
    
    plus 在接口中 Temporal
    
    参数:
    
    amount - 增减的量
    
    unit - 时间单位
    
    返回:
    
    增减后的 DateTime
  - plus
```
public DateTime<T> plus(TemporalAmount amountToAdd)
```
    对 DateTime 进行增减操作。
    
    指定者:
    
    plus 在接口中 Temporal
    
    参数:
    
    amountToAdd - 增减的量
    
    返回:
    
    增减后的 DateTime
  - plusYears
```
public DateTime<T> plusYears(long years)
```
  - plusMonths
```
public DateTime<T> plusMonths(long months)
```
  - plusDays
```
public DateTime<T> plusDays(long days)
```
  - plusHours
```
public DateTime<T> plusHours(long hours)
```
  - plusMinutes
```
public DateTime<T> plusMinutes(long minutes)
```
  - plusSeconds
```
public DateTime<T> plusSeconds(long seconds)
```
  - plusMillis
```
public DateTime<T> plusMillis(long millis)
```
  - plusMicros
```
public DateTime<T> plusMicros(long micros)
```
  - plusNanos
```
public DateTime<T> plusNanos(long nanos)
```
  - minus
```
public DateTime<T> minus(long amount,
                         TemporalUnit unit)
```
    对 DateTime 进行增减操作。
    注： Instant 类型的时间会先转成 TZ.DEFAULT_ZONE 时区的 ZonedDateTime 进行增减。
    
    指定者:
    
    minus 在接口中 Temporal
    
    参数:
    
    amount - 增减的量
    
    unit - 时间单位
    
    返回:
    
    增减后的 DateTime
  - minus
```
public DateTime<T> minus(TemporalAmount amountToSubtract)
```
    对 DateTime 进行增减操作。
    
    指定者:
    
    minus 在接口中 Temporal
    
    参数:
    
    amountToSubtract - 增减的量
    
    返回:
    
    增减后的 DateTime
  - minusYears
```
public DateTime<T> minusYears(long years)
```
  - minusMonths
```
public DateTime<T> minusMonths(long months)
```
  - minusDays
```
public DateTime<T> minusDays(long days)
```
  - minusHours
```
public DateTime<T> minusHours(long hours)
```
  - minusMinutes
```
public DateTime<T> minusMinutes(long minutes)
```
  - minusSeconds
```
public DateTime<T> minusSeconds(long seconds)
```
  - minusMillis
```
public DateTime<T> minusMillis(long millis)
```
  - minusMicros
```
public DateTime<T> minusMicros(long micros)
```
  - minusNanos
```
public DateTime<T> minusNanos(long nanos)
```
  - with
```
public DateTime<T> with(TemporalAdjuster adjuster)
```
    指定者:
    
    with 在接口中 Temporal
  - with
```
public DateTime<T> with(TemporalField field,
                        long newValue)
```
    指定者:
    
    with 在接口中 Temporal
  - withYear
```
public DateTime<T> withYear(int year)
```
  - withMonth
```
public DateTime<T> withMonth(int month)
```
  - withDayOfYear
```
public DateTime<T> withDayOfYear(int dayOfYear)
```
  - withDayOfMonth
```
public DateTime<T> withDayOfMonth(int dayOfMonth)
```
  - withHour
```
public DateTime<T> withHour(int hour)
```
  - withMinute
```
public DateTime<T> withMinute(int minute)
```
  - withSecond
```
public DateTime<T> withSecond(int second)
```
  - withNano
```
public DateTime<T> withNano(int nanoOfSecond)
```
  - get
```
public int get(TemporalField field)
```
    指定者:
    
    get 在接口中 TemporalAccessor
  - getYear
```
public int getYear()
```
  - getMonthValue
```
public int getMonthValue()
```
  - getMonth
```
public Month getMonth()
```
  - getDayOfYear
```
public int getDayOfYear()
```
  - getDayOfMonth
```
public int getDayOfMonth()
```
  - getDayOfWeek
```
public DayOfWeek getDayOfWeek()
```
  - getHour
```
public int getHour()
```
  - getMinute
```
public int getMinute()
```
  - getSecond
```
public int getSecond()
```
  - getMillis
```
public int getMillis()
```
  - getMicros
```
public int getMicros()
```
  - getNano
```
public int getNano()
```
  - round
```
public DateTime<T> round(ChronoUnit chronoUnit,
                         RoundingDT roundingDT)
```
    对 DateTime 进行取整
    
    参数:
    
    chronoUnit - 按此时间单位作为取整后的精度
    
    roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR
    
    返回:
    
    取整后的时间
  - roundTime
```
public DateTime<T> roundTime(ChronoUnit chronoUnit,
                             int amountUnit,
                             RoundingDT roundingDT)
```
    对 DateTime 的时，分，秒进行取整。
    
    参数:
    
    chronoUnit - 按此时间单位作为取整后的精度
    
    amountUnit - 时间步长（不分正负）
    
    roundingDT - 取整类型，值为null默认为：RoundingDT.FLOOR
    
    返回:
    
    取整后的时间
  - datesByShift
```
public List<T> datesByShift(int shiftTimes,
                            int amountUnit,
                            ChronoUnit chronoUnit,
                            boolean includeCurrentTime)
```
    从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
    
    参数:
    
    shiftTimes - 偏移的次数，负数：则时间往前偏移；正数：则时间往后偏移
    
    amountUnit - 偏移的步长（不分正负）
    
    chronoUnit - 时间单位
    
    includeCurrentTime - 最后列表是否包含 fromDate
    
    返回:
    
    每次偏移后的所有时间列表
  - datesByShift
```
public List<T> datesByShift(int shiftTimes,
                            ChronoUnit chronoUnit,
                            boolean includeCurrentTime)
```
    从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
    
    参数:
    
    shiftTimes - 偏移的次数，负数：则时间往前偏移；正数：则时间往后偏移
    
    chronoUnit - 时间单位
    
    includeCurrentTime - 最后列表是否包含 fromDate
    
    返回:
    
    每次偏移后的所有时间列表
  - datesByShift
```
public List<T> datesByShift(int shiftTimes,
                            ChronoUnit chronoUnit)
```
    从给定的时间，按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
    
    参数:
    
    shiftTimes - 偏移的次数，负数：则时间往前偏移；正数：则时间往后偏移
    
    chronoUnit - 时间单位
    
    返回:
    
    每次偏移后的所有时间列表
  - datesFromRange
```
public List<T> datesFromRange(DateTime<?> toDateTime,
                              int amountUnit,
                              ChronoUnit chronoUnit,
                              IntervalType intervalType)
```
    从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
    
    参数:
    
    toDateTime - 结束的时间
    
    amountUnit - 偏移的步长（不分正负）
    
    chronoUnit - 时间单位
    
    intervalType - 区间类型
    
    返回:
    
    每次偏移后的所有时间列表
  - datesFromRange
```
public List<T> datesFromRange(DateTime<?> toDateTime,
                              ChronoUnit chronoUnit,
                              IntervalType intervalType)
```
    从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
    
    参数:
    
    toDateTime - 结束的时间
    
    chronoUnit - 时间单位
    
    intervalType - 区间类型
    
    返回:
    
    每次偏移后的所有时间列表
  - datesFromRange
```
public List<T> datesFromRange(DateTime<?> toDateTime,
                              ChronoUnit chronoUnit)
```
    从给定的时间范围（开始时间，结束时间），按指定的时间单位，指定的步长偏移时间，返回每次偏移后的所有时间列表
    
    参数:
    
    toDateTime - 结束的时间
    
    chronoUnit - 时间单位
    
    返回:
    
    每次偏移后的所有时间列表
  - fill0
```
public DateTime<T> fill0(ChronoUnit chronoUnit)
```
    保留所提供的chronoUnit以及比chronoUnit大的单位的值，填充比 chronoUnit 小的单位的值为 0。
    
    参数:
    
    chronoUnit - 时间单位
    
    返回:
    
    DateTime
    
    从以下版本开始:
    
    0.3.1
  - fill9
```
public DateTime<T> fill9(ChronoUnit chronoUnit)
```
    保留所提供的chronoUnit以及比chronoUnit大的单位的值，填充比 chronoUnit 小的单位的值为所允许的最大值。
    
    参数:
    
    chronoUnit - 时间单位
    
    返回:
    
    DateTime
    
    从以下版本开始:
    
    0.3.1
  - daysOfMonth
```
public int daysOfMonth()
```
    获取某个月的总天数
    
    返回:
    
    当前月的总天数
  - format
```
public String format(String dtPattern)
```
    Formats this date-time using the specified DateTime Pattern
    
    参数:
    
    dtPattern - DateTime Pattern
    
    返回:
    
    the formatted date-time string, not null
  - format
```
public String format(DateTimeFormatter formatter)
```
    Formats this date-time using the specified formatter
    
    参数:
    
    formatter - DateTimeFormatter
    
    返回:
    
    the formatted date-time string, not null
  - parse
```
public static DateTime<LocalDateTime> parse(CharSequence text)
```
    Obtains an instance of DateTime<LocalDateTime> by intelligently determining the format of a time text.
    
    参数:
    
    text - the text to parse, not null
    
    返回:
    
    DateTime<LocalDateTime>
    
    抛出:
    
    DateTimeParseException - if the text cannot be parsed
    
    从以下版本开始:
    
    0.3.1
  - parse
```
public static DateTime<LocalDateTime> parse(CharSequence text,
                                            String dtPattern)
```
  - parse
```
public static DateTime<LocalDateTime> parse(CharSequence text,
                                            DateTimeFormatter formatter)
```
    Obtains an instance of DateTime<LocalDateTime> from a text string using a specific formatter.
    The text is parsed using the formatter, returning a date-time.
    
    参数:
    
    text - the text to parse, not null
    
    formatter - the formatter to use, not null
    
    返回:
    
    DateTime of LocalDateTime
    
    抛出:
    
    DateTimeParseException - if the text cannot be parsed
    
    从以下版本开始:
    
    0.3.1
  - parseDate
```
public static DateTime<Date> parseDate(CharSequence text)
```
    Obtains an instance of DateTime<Date> from a text intelligently.
    
    参数:
    
    text - the text to parse, not null
    
    返回:
    
    DateTime<Date>
    
    抛出:
    
    DateTimeParseException - if the text cannot be parsed
    
    从以下版本开始:
    
    0.3.1
  - parseDate
```
public static DateTime<Date> parseDate(CharSequence text,
                                       ZoneId zoneId)
```
    Obtains an instance of DateTime<Date> from a text string using a formatter that is intelligently selected through the system.
    
    参数:
    
    text - the text to parse, not null
    
    zoneId - zoneId
    
    返回:
    
    DateTime<Date>
    
    抛出:
    
    DateTimeParseException - if the text cannot be parsed
    
    从以下版本开始:
    
    0.3.1
  - parseDate
```
public static DateTime<Date> parseDate(CharSequence text,
                                       String dtPattern)
```
  - parseDate
```
public static DateTime<Date> parseDate(CharSequence text,
                                       String dtPattern,
                                       ZoneId zoneId)
```
  - parseDate
```
public static DateTime<Date> parseDate(CharSequence text,
                                       DateTimeFormatter formatter)
```
  - parseDate
```
public static DateTime<Date> parseDate(CharSequence text,
                                       DateTimeFormatter formatter,
                                       ZoneId zoneId)
```
    从时间格式串中获取 DateTime<Date>
    
    参数:
    
    text - 时间格式串
    
    formatter - formatter
    
    zoneId - 时间格式串所属的时区。null 则为默认时区。
    
    返回:
    
    DateTime<Date>
    
    从以下版本开始:
    
    0.3.1
  - compatibleFormatter
```
private static com.iofairy.tuple.Tuple2<CharSequence,String> compatibleFormatter(CharSequence text,
                                                                                 String dtPattern)
```
    The date time format is compatible with yyyyMMddHHmmssSSS.
    NOTE:
    Java 8 bug: DateTimeFormatter fails on parsing "yyyyMMddHHmmssSSS"
    
    参数:
    
    text - date time string
    
    dtPattern - date time pattern
    
    返回:
    
    parsed text and dtPattern
    
    从以下版本开始:
    
    0.4.0
  - until
```
public long until(Temporal endExclusive,
                  TemporalUnit unit)
```
    指定者:
    
    until 在接口中 Temporal
  - isSupported
```
public boolean isSupported(TemporalUnit unit)
```
    指定者:
    
    isSupported 在接口中 Temporal
  - isSupported
```
public boolean isSupported(TemporalField field)
```
    指定者:
    
    isSupported 在接口中 TemporalAccessor
  - getLong
```
public long getLong(TemporalField field)
```
    指定者:
    
    getLong 在接口中 TemporalAccessor
  - dtInThisWeek
```
public DateTime<T> dtInThisWeek(DayOfWeek dayOfWeek)
```
    获取当前日期所在周的任意星期几的日期（默认每周的第一天为星期一）
    
    参数:
    
    dayOfWeek - 取星期几的日期
    
    返回:
    
    当前日期所在周的任意星期几的日期
    
    从以下版本开始:
    
    0.3.4
  - dtInThisWeek
```
public DateTime<T> dtInThisWeek(DayOfWeek firstDayOfWeek,
                                DayOfWeek dayOfWeek)
```
    获取当前日期所在周的任意星期几的日期
    
    参数:
    
    firstDayOfWeek - 指定每周的第一天是星期几
    
    dayOfWeek - 取星期几的日期
    
    返回:
    
    当前日期所在周的任意星期几的日期
    
    从以下版本开始:
    
    0.3.4
  - firstInThisWeek
```
public DateTime<T> firstInThisWeek()
```
    获取当前日期所在周的第一天（默认每周的第一天为星期一）
    
    返回:
    
    当前日期所在周的第一天
    
    从以下版本开始:
    
    0.3.4
  - firstInThisWeek
```
public DateTime<T> firstInThisWeek(DayOfWeek firstDayOfWeek)
```
    获取当前日期所在周的第一天
    
    参数:
    
    firstDayOfWeek - 指定每周的第一天是星期几
    
    返回:
    
    当前日期所在周的第一天
    
    从以下版本开始:
    
    0.3.4
  - lastInThisWeek
```
public DateTime<T> lastInThisWeek()
```
    获取当前日期所在周的最后一天（默认每周的第一天为星期一）
    
    返回:
    
    当前日期所在周的最后一天
    
    从以下版本开始:
    
    0.3.4
  - lastInThisWeek
```
public DateTime<T> lastInThisWeek(DayOfWeek firstDayOfWeek)
```
    获取当前日期所在周的最后一天
    
    参数:
    
    firstDayOfWeek - 指定每周的第一天是星期几
    
    返回:
    
    当前日期所在周的最后一天
    
    从以下版本开始:
    
    0.3.4
  - allDaysInThisWeek
```
public List<DateTime<T>> allDaysInThisWeek()
```
    获取当前日期所在周的所有7天的日期（默认每周的第一天为星期一）
    
    返回:
    
    当前日期所在周的所有7天的日期
    
    从以下版本开始:
    
    0.3.4
  - allDaysInThisWeek
```
public List<DateTime<T>> allDaysInThisWeek(DayOfWeek firstDayOfWeek)
```
    获取当前日期所在周的所有7天的日期
    
    参数:
    
    firstDayOfWeek - 指定每周的第一天是星期几
    
    返回:
    
    当前日期所在周的所有7天的日期
    
    从以下版本开始:
    
    0.3.4
  - isBefore
```
public boolean isBefore(DateTime<?> otherDT)
```
  - isAfter
```
public boolean isAfter(DateTime<?> otherDT)
```
  - isBeforeOrEquals
```
public boolean isBeforeOrEquals(DateTime<?> otherDT)
```
  - isAfterOrEquals
```
public boolean isAfterOrEquals(DateTime<?> otherDT)
```
  - in
```
public boolean in(DateTime<?> startDT,
                  DateTime<?> endDT,
                  IntervalType intervalType)
```
    判断当前 DateTime 是否在提供的两个 DateTime 之间
    
    参数:
    
    startDT - 开始 DateTime
    
    endDT - 结束 DateTime
    
    intervalType - 区间类型。
    
    返回:
    
    当前 DateTime 在提供的两个 DateTime 之间，则返回 true，否则返回 false
    
    抛出:
    
    com.iofairy.except.UnexpectedParameterException - if endDT is before startDT
    
    从以下版本开始:
    
    0.3.3
  - toEpochSecond
```
public long toEpochSecond()
```
  - toEpochMilli
```
public long toEpochMilli()
```
  - equals
```
public boolean equals(Object obj)
```
    覆盖:
    
    equals 在类中 Object
  - compareTo
```
public int compareTo(DateTime<?> otherDT)
```
    指定者:
    
    compareTo 在接口中 Comparable<T>
  - dtDetail
```
public String dtDetail()
```
    详细的 toString
    
    返回:
    
    时间格式化输出
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object

类 DateTime<T>

字段概要

构造器概要

方法概要

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

从接口继承的方法 java.time.temporal.TemporalAccessor

字段详细资料

serialVersionUID

dateTime

localDateTime

offset

zone

instant

zonedDateTime

offsetDateTime

SUPPORTED_DATETIME

SUPPORTED_DATETIME_STRING

EXCLUDED_CLASS_NAMES

DT_PARSE_ERROR_MSG_TPL

构造器详细资料

DateTime

DateTime

方法详细资料

of

from

getDateTime

get

now

nowDate

nowInstant

getLocalDateTime

getOffset

getZone

getInstant

getZonedDateTime

getOffsetDateTime

toZDTAndInstant

toUTCZonedDT

toDefaultZonedDT

toZonedDT

toUTCOffsetDT

toDefaultOffsetDT

toOffsetDT

toUTCCalendar

toDefaultCalendar

toCalendar

toCalendar

toLocalDateTime

toDate

toInstant

plus

plus

plusYears

plusMonths

plusDays

plusHours

plusMinutes

plusSeconds

plusMillis

plusMicros

plusNanos

minus

minus

minusYears

minusMonths

minusDays

minusHours

minusMinutes

minusSeconds

minusMillis

minusMicros

minusNanos

with

with

withYear

withMonth

withDayOfYear

withDayOfMonth

withHour

withMinute