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

java.lang.Object
- com.iofairy.falcon.time.DateTimes

public final class DateTimes
extends Object

DateTime Utils

从以下版本开始:: 0.3.0

字段概要

字段
限定符和类型字段说明

private static List<Class<? extends Temporal>> SUPPORTED_TEMPORAL_FOR_DOM
Supported temporal for daysOfMonth methods.

字段
限定符和类型	字段	说明
`private static List<Class<? extends Temporal>>`	`SUPPORTED_TEMPORAL_FOR_DOM`	Supported temporal for `daysOfMonth` methods.

构造器概要

构造器
构造器说明

DateTimes()

构造器
构造器	说明
`DateTimes()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法	说明
`static Calendar`	`clone(Calendar calendar)`	克隆一个 Calendar
`static Date`	`clone(Date date)`	克隆一个 Date
`static com.iofairy.tuple.Tuple2<Integer,Integer>`	`daysBetween(DayOfWeek startDayOfWeek, DayOfWeek endDayOfWeek)`	获取两个星期几之间相差的天数。
`static int`	`daysOfMonth(int year, int month)`	获取某个月的总天数
`static int`	`daysOfMonth(Temporal temporal)`	获取某个月的总天数
`static Date`	`defaultDateToTZ(Date date, ZoneId zoneId)`	Convert local Date object to another timezone 将默认Date时间对象转成另一个时区的Date对象
`static LocalDateTime`	`defaultLocalDTToTZ(LocalDateTime localDateTime, ZoneId zoneId)`	Convert local LocalDateTime object to another timezone 将默认LocalDateTime时间对象转成另一个时区的LocalDateTime对象
`static ZoneOffset`	`defaultOffset()`	获取当前系统当前时间的时区偏移`ZoneOffset`。
`static DayOfWeek`	`getLastDayOfWeek(DayOfWeek firstDayOfWeek)`	通过每周的第一天，计算每周的最后一天
`static Map<ZoneOffset,List<ZoneId>>`	`getOffsetZoneIds()`	获取当前时间的 ZoneOffset 以及对应的 ZoneId 列表。
`static List<ZoneId>`	`getZoneIds(ZoneOffset zoneOffset)`	通过zoneOffset获取对应的ZoneId集合
`static List<String>`	`hourMinutesOfDay(boolean withZeroSecond, String separator)`	一天中的所有分钟
`static List<String>`	`hoursOfDay(int withMode, String separator)`	使用指定格式返回一天中的24小时
`static List<String>`	`hoursOfDay(String day, int withMode)`	使用指定格式返回一天中的24小时
`static List<String>`	`hoursOfDay(String day, int withMode, String separator)`	使用指定格式返回一天中的24小时
`static List<String>`	`minutesOfHour(String hour, boolean withZeroSecond, String separator)`	某个指定小时的所有分钟
`static List<String>`	`secondsOfMinute(String minute, String separator)`	某个指定分钟的所有秒
`static Calendar`	`toCalendar(Instant instant)`	Instant 转成 Calendar
`static Calendar`	`toCalendar(OffsetDateTime offsetDateTime)`	OffsetDateTime 转成 Calendar
`static Calendar`	`toCalendar(ZonedDateTime zonedDateTime)`	ZonedDateTime 转成 Calendar
`static Calendar`	`toCalendar(Calendar calendar, ZoneId zoneId)`	Calendar 转成其他时区，返回新的 Calendar 对象
`static Calendar`	`toCalendar(Date date, ZoneId zoneId)`	Date 转 Calendar
`static BigInteger`	`toMicros(long amount, ChronoUnit chronoUnit)`	将某个时间类型转为微秒
`static BigInteger`	`toNanos(long amount, ChronoUnit chronoUnit)`	将某个时间类型转为纳秒
`static ZonedDateTime`	`toZonedDT(Calendar calendar, ZoneId toZoneId)`	将 calendar 转成与之相同时区的 ZonedDateTime，或指定时区的 `toZoneId` ZonedDateTime。
`static Date`	`tzDateToTZ(Date date, ZoneId fromZoneId, ZoneId toZoneId)`	Convert fromZoneId Date to toZoneId 将Date对象从一个时区转成另一个时区的Date对象
`static ZonedDateTime`	`tzDateToZonedDT(Date date, ZoneId fromZoneId, ZoneId toZoneId)`	Convert date from fromZoneId Date to toZoneId ZonedDateTime 将一个时区的 Date 转成另一个时区的 ZonedDateTime
`static LocalDateTime`	`tzLocalDTToTZ(LocalDateTime localDateTime, ZoneId fromZoneId, ZoneId toZoneId)`	Convert fromZoneId LocalDateTime to toZoneId 将LocalDateTime对象从一个时区转成另一个时区的LocalDateTime对象
`static ZoneOffset`	`zoneOffset(String zoneIdName)`	通过ZoneId名称获取当前时间的时区偏移`ZoneOffset`。
`static ZoneOffset`	`zoneOffset(ZoneId zoneId)`	通过ZoneId获取当前时间的时区偏移`ZoneOffset`。
`static ZoneOffset`	`zoneOffset(ZoneId zoneId, Instant instant)`	根据指定 zoneId 与 instant 获取当时的时区偏移`ZoneOffset`。
`static ZoneOffset`	`zoneOffset(Calendar calendar)`	获取 calendar 的时区偏移`ZoneOffset`

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

- 字段详细资料
  - SUPPORTED_TEMPORAL_FOR_DOM
```
private static final List<Class<? extends Temporal>> SUPPORTED_TEMPORAL_FOR_DOM
```
    Supported temporal for daysOfMonth methods.
- 构造器详细资料
  - DateTimes
```
public DateTimes()
```
- 方法详细资料
  - getOffsetZoneIds
```
public static Map<ZoneOffset,List<ZoneId>> getOffsetZoneIds()
```
    获取当前时间的 ZoneOffset 以及对应的 ZoneId 列表。由于有些地区有夏令时，不同时间结果会不一样。所以需要实时获取。
    
    返回:
    
    ZoneOffset 以及对应的 ZoneId 列表
  - getZoneIds
```
public static List<ZoneId> getZoneIds(ZoneOffset zoneOffset)
```
    通过zoneOffset获取对应的ZoneId集合
    
    参数:
    
    zoneOffset - zoneOffset
    
    返回:
    
    ZoneId列表
  - defaultOffset
```
public static ZoneOffset defaultOffset()
```
    获取当前系统当前时间的时区偏移ZoneOffset。由于有些地区有夏令时，不同时间结果会不一样。所以需要实时获取。
    
    返回:
    
    ZoneOffset
  - zoneOffset
```
public static ZoneOffset zoneOffset(String zoneIdName)
```
    通过ZoneId名称获取当前时间的时区偏移ZoneOffset。
    
    参数:
    
    zoneIdName - ZoneId名称
    
    返回:
    
    ZoneOffset
  - zoneOffset
```
public static ZoneOffset zoneOffset(ZoneId zoneId)
```
    通过ZoneId获取当前时间的时区偏移ZoneOffset。
    
    参数:
    
    zoneId - ZoneId
    
    返回:
    
    ZoneOffset
  - zoneOffset
```
public static ZoneOffset zoneOffset(ZoneId zoneId,
                                    Instant instant)
```
    根据指定 zoneId 与 instant 获取当时的时区偏移ZoneOffset。
    由于有些地区有夏令时，不同时间结果ZoneOffset会不一样。所以需要根据指定的 instant 获取。
    
    参数:
    
    zoneId - zoneId
    
    instant - instant
    
    返回:
    
    ZoneOffset
  - zoneOffset
```
public static ZoneOffset zoneOffset(Calendar calendar)
```
    获取 calendar 的时区偏移ZoneOffset
    
    参数:
    
    calendar - calendar
    
    返回:
    
    ZoneOffset
  - defaultDateToTZ
```
public static Date defaultDateToTZ(Date date,
                                   ZoneId zoneId)
```
    Convert local Date object to another timezone
    将默认Date时间对象转成另一个时区的Date对象
    
    参数:
    
    date - date
    
    zoneId - zoneId
    
    返回:
    
    another timezone Date
  - tzDateToTZ
```
public static Date tzDateToTZ(Date date,
                              ZoneId fromZoneId,
                              ZoneId toZoneId)
```
    Convert fromZoneId Date to toZoneId
    将Date对象从一个时区转成另一个时区的Date对象
    
    参数:
    
    date - date
    
    fromZoneId - fromZoneId. 当 fromZoneId 为 null时，采用 TZ.DEFAULT_ZONE
    
    toZoneId - toZoneId. 当 toZoneId 为 null时，采用 TZ.DEFAULT_ZONE
    
    返回:
    
    another timezone Date
  - defaultLocalDTToTZ
```
public static LocalDateTime defaultLocalDTToTZ(LocalDateTime localDateTime,
                                               ZoneId zoneId)
```
    Convert local LocalDateTime object to another timezone
    将默认LocalDateTime时间对象转成另一个时区的LocalDateTime对象
    
    参数:
    
    localDateTime - LocalDateTime
    
    zoneId - zoneId
    
    返回:
    
    another timezone LocalDateTime
  - tzLocalDTToTZ
```
public static LocalDateTime tzLocalDTToTZ(LocalDateTime localDateTime,
                                          ZoneId fromZoneId,
                                          ZoneId toZoneId)
```
    Convert fromZoneId LocalDateTime to toZoneId
    将LocalDateTime对象从一个时区转成另一个时区的LocalDateTime对象
    
    参数:
    
    localDateTime - LocalDateTime
    
    fromZoneId - fromZoneId. 当 fromZoneId 为 null时，采用 TZ.DEFAULT_ZONE
    
    toZoneId - toZoneId. 当 toZoneId 为 null时，采用 TZ.DEFAULT_ZONE
    
    返回:
    
    another timezone LocalDateTime
  - tzDateToZonedDT
```
public static ZonedDateTime tzDateToZonedDT(Date date,
                                            ZoneId fromZoneId,
                                            ZoneId toZoneId)
```
    Convert date from fromZoneId Date to toZoneId ZonedDateTime
    将一个时区的 Date 转成另一个时区的 ZonedDateTime
    
    参数:
    
    date - date
    
    fromZoneId - fromZoneId. 当 fromZoneId 为 null时，采用 TZ.DEFAULT_ZONE
    
    toZoneId - toZoneId. 当 toZoneId 为 null时，采用 TZ.DEFAULT_ZONE
    
    返回:
    
    ZonedDateTime
  - toZonedDT
```
public static ZonedDateTime toZonedDT(Calendar calendar,
                                      ZoneId toZoneId)
```
    将 calendar 转成与之相同时区的 ZonedDateTime，或指定时区的 toZoneId ZonedDateTime。
    
    参数:
    
    calendar - calendar
    
    toZoneId - 指定转换的目标时区
    
    返回:
    
    ZonedDateTime
    
    从以下版本开始:
    
    0.4.0
  - toCalendar
```
public static Calendar toCalendar(Date date,
                                  ZoneId zoneId)
```
    Date 转 Calendar
    
    参数:
    
    date - date
    
    zoneId - 时区。当前 zoneId 为 null 时，采用默认时区。
    
    返回:
    
    Calendar
    
    从以下版本开始:
    
    0.3.0
  - toCalendar
```
public static Calendar toCalendar(Calendar calendar,
                                  ZoneId zoneId)
```
    Calendar 转成其他时区，返回新的 Calendar 对象
    
    参数:
    
    calendar - calendar
    
    zoneId - 时区。当前 zoneId 为 null 时，采用默认时区。
    
    返回:
    
    Calendar
    
    从以下版本开始:
    
    0.3.0
  - toCalendar
```
public static Calendar toCalendar(Instant instant)
```
    Instant 转成 Calendar
    
    参数:
    
    instant - instant
    
    返回:
    
    Calendar
    
    从以下版本开始:
    
    0.3.0
  - toCalendar
```
public static Calendar toCalendar(ZonedDateTime zonedDateTime)
```
    ZonedDateTime 转成 Calendar
    
    参数:
    
    zonedDateTime - zonedDateTime
    
    返回:
    
    Calendar
    
    从以下版本开始:
    
    0.3.0
  - toCalendar
```
public static Calendar toCalendar(OffsetDateTime offsetDateTime)
```
    OffsetDateTime 转成 Calendar
    
    参数:
    
    offsetDateTime - offsetDateTime
    
    返回:
    
    Calendar
    
    从以下版本开始:
    
    0.3.0
  - clone
```
public static Calendar clone(Calendar calendar)
```
    克隆一个 Calendar
    
    参数:
    
    calendar - calendar
    
    返回:
    
    Calendar
    
    从以下版本开始:
    
    0.3.0
  - clone
```
public static Date clone(Date date)
```
    克隆一个 Date
    
    参数:
    
    date - date
    
    返回:
    
    Date
    
    从以下版本开始:
    
    0.3.3
  - toMicros
```
public static BigInteger toMicros(long amount,
                                  ChronoUnit chronoUnit)
```
    将某个时间类型转为微秒
    
    参数:
    
    amount - 时间量
    
    chronoUnit - 时间单位
    
    返回:
    
    总微秒数
    
    从以下版本开始:
    
    0.3.0
  - toNanos
```
public static BigInteger toNanos(long amount,
                                 ChronoUnit chronoUnit)
```
    将某个时间类型转为纳秒
    
    参数:
    
    amount - 时间量
    
    chronoUnit - 时间单位
    
    返回:
    
    总纳秒数
    
    从以下版本开始:
    
    0.3.0
  - daysOfMonth
```
public static int daysOfMonth(int year,
                              int month)
```
    获取某个月的总天数
    
    参数:
    
    year - 当前年份
    
    month - 当前月份
    
    返回:
    
    当前月的总天数
    
    从以下版本开始:
    
    0.3.0
  - daysOfMonth
```
public static int daysOfMonth(Temporal temporal)
```
    获取某个月的总天数
    
    参数:
    
    temporal - temporal
    
    返回:
    
    当前月的总天数
    
    从以下版本开始:
    
    0.3.0
  - daysBetween
```
public static com.iofairy.tuple.Tuple2<Integer,Integer> daysBetween(DayOfWeek startDayOfWeek,
                                                                    DayOfWeek endDayOfWeek)
```
    获取两个星期几之间相差的天数。
    
    参数:
    
    startDayOfWeek - 开始的星期几
    
    endDayOfWeek - 结束的星期几
    
    返回:
    
    返回 Tuple2(previousDays, nextDays) 值。
    Tuple2 第一个值为：startDayOfWeek 与其前面一个 endDayOfWeek 相差的天数；
    Tuple2 第二个值为：startDayOfWeek 与其后面一个 endDayOfWeek 相差的天数。
    
    从以下版本开始:
    
    0.3.4
  - getLastDayOfWeek
```
public static DayOfWeek getLastDayOfWeek(DayOfWeek firstDayOfWeek)
```
    通过每周的第一天，计算每周的最后一天
    
    参数:
    
    firstDayOfWeek - 每周第一天
    
    返回:
    
    每周最后一天
    
    从以下版本开始:
    
    0.3.4
  - hoursOfDay
```
public static List<String> hoursOfDay(int withMode,
                                      String separator)
```
    使用指定格式返回一天中的24小时
    
    参数:
    
    withMode - 0: 只返回小时；1：返回小时并在末尾拼接上00分钟；2：返回小时并在末尾拼接00分钟和00秒
    
    separator - 当 withMode 为 1，2时，需要指定分隔符。如果为 null，则默认采用 ""
    
    返回:
    
    一天中的小时
    
    从以下版本开始:
    
    0.3.0
  - hoursOfDay
```
public static List<String> hoursOfDay(String day,
                                      int withMode)
```
    使用指定格式返回一天中的24小时
    
    参数:
    
    day - 指定的天
    
    withMode - 0: 只返回小时；1：返回小时并在末尾拼接上00分钟；2：返回小时并在末尾拼接00分钟和00秒
    
    返回:
    
    一天中的小时
    
    从以下版本开始:
    
    0.3.3
  - hoursOfDay
```
public static List<String> hoursOfDay(String day,
                                      int withMode,
                                      String separator)
```
    使用指定格式返回一天中的24小时
    
    参数:
    
    day - 指定的天
    
    withMode - 0: 只返回小时；1：返回小时并在末尾拼接上00分钟；2：返回小时并在末尾拼接00分钟和00秒
    
    separator - 当 withMode 为 1，2时，需要指定分隔符。如果为 null，则默认采用 ""
    
    返回:
    
    一天中的小时
    
    从以下版本开始:
    
    0.3.3
  - hourMinutesOfDay
```
public static List<String> hourMinutesOfDay(boolean withZeroSecond,
                                            String separator)
```
    一天中的所有分钟
    
    参数:
    
    withZeroSecond - 是否在末尾拼接00秒
    
    separator - 拼接时采用的分隔符。如果为 null，则默认采用 ""
    
    返回:
    
    一天中的所有分钟
    
    从以下版本开始:
    
    0.3.0
  - minutesOfHour
```
public static List<String> minutesOfHour(String hour,
                                         boolean withZeroSecond,
                                         String separator)
```
    某个指定小时的所有分钟
    
    参数:
    
    hour - 时。如果为 null，则默认采用 ""
    
    withZeroSecond - 是否在末尾拼接00秒
    
    separator - 拼接时采用的分隔符。如果为 null，则默认采用 ""
    
    返回:
    
    某个指定小时的所有分钟
    
    从以下版本开始:
    
    0.3.0
  - secondsOfMinute
```
public static List<String> secondsOfMinute(String minute,
                                           String separator)
```
    某个指定分钟的所有秒
    
    参数:
    
    minute - 分钟。如果为 null，则默认采用 ""
    
    separator - 拼接时采用的分隔符。如果为 null，则默认采用 ""
    
    返回:
    
    某个指定分钟的所有秒
    
    从以下版本开始:
    
    0.3.0

类 DateTimes

字段概要

构造器概要

方法概要

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

字段详细资料

SUPPORTED_TEMPORAL_FOR_DOM

构造器详细资料

DateTimes

方法详细资料

getOffsetZoneIds

getZoneIds

defaultOffset

zoneOffset

zoneOffset

zoneOffset

zoneOffset

defaultDateToTZ

tzDateToTZ

defaultLocalDTToTZ

tzLocalDTToTZ

tzDateToZonedDT

toZonedDT

toCalendar

toCalendar

toCalendar

toCalendar

toCalendar

clone

clone

toMicros

toNanos

daysOfMonth

daysOfMonth

daysBetween

getLastDayOfWeek

hoursOfDay

hoursOfDay

hoursOfDay

hourMinutesOfDay

minutesOfHour

secondsOfMinute