ChronoUnit (Java Platform SE 8 )

java.lang.Object
- java.lang.Enum<ChronoUnit>
- - java.time.temporal.ChronoUnit

All Implemented Interfaces:

Serializable ， Comparable < ChronoUnit >， TemporalUnit
```
public enum ChronoUnit
extends Enum<ChronoUnit>
implements TemporalUnit
```
一组标准的日期单位。
这组单位提供基于单位的访问来操纵日期，时间或日期时间。可以通过实施TemporalUnit扩展标准的单位。

这些单元适用于多个日历系统。例如，大多数非ISO日历系统定义了几个月，几个月和几天的单位，只是略有不同的规则。每个单元的文档说明它如何运作。

实现要求：

这是一个最终的，不可变的和线程安全的枚举。

从以下版本开始：

1.8

Enum Constant Summary

Enum Constants
Enum Constant and Description
`CENTURIES` 代表一个世纪概念的单位。
`DAYS` 代表一天概念的单位。
`DECADES` 代表十年概念的单位。
`ERAS` 代表一个时代概念的单位。
`FOREVER` 代表永恒概念的人造单位。
`HALF_DAYS` 代表AM / PM使用的半天的概念的单位。
`HOURS` 代表一小时概念的单位。
`MICROS` 代表微秒的概念的单位。
`MILLENNIA` 代表千年概念的单位。
`MILLIS` 代表毫秒概念的单位。
`MINUTES` 代表一分钟概念的单位。
`MONTHS` 代表一个月概念的单位。
`NANOS` 代表纳秒概念的单位，最小支持的时间单位。
`SECONDS` 代表第二个概念的单位。
`WEEKS` 代表一周概念的单位。
`YEARS` 代表一年概念的单位。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`<R extends Temporal> R`	`addTo(R temporal, long amount)` 返回添加指定句点的指定时间对象的副本。
`long`	`between(Temporal temporal1Inclusive, Temporal temporal2Exclusive)` 计算两个时间对象之间的时间量。
`Duration`	`getDuration()` 在ISO日历系统中获取本机的预计持续时间。
`boolean`	`isDateBased()` 检查本机是否是日期单位。
`boolean`	`isDurationEstimated()` 检查单位的持续时间是否是估计。
`boolean`	`isSupportedBy(Temporal temporal)` 检查本机是否受指定的时间对象的支持。
`boolean`	`isTimeBased()` 检查本机是否是时间单位。
`String`	`toString()` 返回声明中包含的此枚举常量的名称。
`static ChronoUnit`	`valueOf(String name)` 以指定的名称返回此类型的枚举常量。
`static ChronoUnit[]`	`values()` 按照它们声明的顺序返回一个包含此枚举类型常量的数组。

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - NANOS
```
public static final ChronoUnit NANOS
```
    代表纳秒概念的单位，最小支持的时间单位。对于ISO日历系统，它等于第二单位的第1,000亿分之一。
  - MICROS
```
public static final ChronoUnit MICROS
```
    代表微秒的概念的单位。对于ISO日历系统，它等于第二单位的第100万部分。
  - MILLIS
```
public static final ChronoUnit MILLIS
```
    代表毫秒概念的单位。对于ISO日历系统，它等于第二单元的第1000部分。
  - SECONDS
```
public static final ChronoUnit SECONDS
```
    代表第二个概念的单位。对于ISO日历系统，它等于SI系统中的第二个单位，除了闰秒。
  - MINUTES
```
public static final ChronoUnit MINUTES
```
    代表一分钟概念的单位。对于ISO日历系统，它等于60秒。
  - HOURS
```
public static final ChronoUnit HOURS
```
    代表一小时概念的单位。对于ISO日历系统，它等于60分钟。
  - HALF_DAYS
```
public static final ChronoUnit HALF_DAYS
```
    代表AM / PM使用的半天的概念的单位。对于ISO日历系统，它等于12小时。
  - DAYS
```
public static final ChronoUnit DAYS
```
    代表一天概念的单位。对于ISO日历系统，这是从午夜到午夜的标准日期。一天的预计持续时间为24 Hours 。
    当与其他日历系统一起使用时，它必须对应于地球上太阳升起和设定所定义的日期。不需要从午夜开始 - 在日历系统之间转换时，日期应在中午相当。
  - WEEKS
```
public static final ChronoUnit WEEKS
```
    代表一周概念的单位。对于ISO日历系统，它等于7天。
    当与其他日历系统一起使用时，它必须对应于整数天。
  - MONTHS
```
public static final ChronoUnit MONTHS
```
    代表一个月概念的单位。对于ISO日历系统，月份的长度因月份而异。一个月的预计持续时间是365.2425 Days十二分之一。
    当与其他日历系统一起使用时，它必须对应于整数天。
  - YEARS
```
public static final ChronoUnit YEARS
```
    代表一年概念的单位。对于ISO日历系统，它等于12个月。一年的预计持续时间为365.2425 Days 。
    当与其他日历系统一起使用时，它必须对应于大约相当于太阳周围地球通过的一年的整数天数。
  - DECADES
```
public static final ChronoUnit DECADES
```
    代表十年概念的单位。对于ISO日历系统，它等于10年。
    当与其他日历系统一起使用时，它必须对应于整数天，通常是整数年。
  - CENTURIES
```
public static final ChronoUnit CENTURIES
```
    代表一个世纪概念的单位。对于ISO日历系统，它等于100年。
    当与其他日历系统一起使用时，它必须对应于整数天，通常是整数年。
  - MILLENNIA
```
public static final ChronoUnit MILLENNIA
```
    代表千年概念的单位。对于ISO日历系统，它等于1000年。
    当与其他日历系统一起使用时，它必须对应于整数天，通常是整数年。
  - ERAS
```
public static final ChronoUnit ERAS
```
    代表一个时代概念的单位。 ISO日历系统没有时间，因此不可能在日期或日期时间添加时代。这个时代的估计时间被人为地定义为1,000,000,000 Years 。
    当与其他日历系统一起使用时，本机没有限制。
  - FOREVER
```
public static final ChronoUnit FOREVER
```
    代表永恒概念的人造单位。这主要用于TemporalField来代表无限的领域，如年份或时代。时代的估计持续时间被人为定义为支持的最大持续时间Duration 。
- 方法详细信息
  - values
```
public static ChronoUnit[] values()
```
    按照它们声明的顺序返回一个包含此枚举类型常量的数组。该方法可用于遍历常量如下：
```
  for (ChronoUnit c : ChronoUnit.values())
    System.out.println(c); 
```
    结果
    
    一个包含这个枚举类型的常量的数组，按照它们被声明的顺序
  - valueOf
```
public static ChronoUnit valueOf(String name)
```
    以指定的名称返回此类型的枚举常量。字符串必须完全匹配用于声明此类型的枚举常量的标识符。（不允许使用外来空白字符。）
    
    参数
    
    name - 要返回的枚举常量的名称。
    
    结果
    
    具有指定名称的枚举常数
    
    异常
    
    IllegalArgumentException - 如果此枚举类型没有指定名称的常量
    
    NullPointerException - 如果参数为空
  - getDuration
```
public Duration getDuration()
```
    在ISO日历系统中获取本机的预计持续时间。
    这个班的所有单位都有预计的时间。天数因夏令时而异，而几个月的长度不同。
    
    Specified by:
    
    getDuration在接口 TemporalUnit
    
    结果
    
    该单位的估计持续时间不为零
  - isDurationEstimated
```
public boolean isDurationEstimated()
```
    检查单位的持续时间是否是估计。
    该课程的所有时间单位都被认为是准确的，而该课程中的所有日期单位都被认为是估计的。
    
    此定义忽略闰秒，但认为由于夏令时和天数不同，天数不同。
    
    Specified by:
    
    isDurationEstimated在界面 TemporalUnit
    
    结果
    
    如果持续时间估计为真，则为真，如果准确
  - isDateBased
```
public boolean isDateBased()
```
    检查本机是否是日期单位。
    从日到日的所有单位都是基于日期的。基于时间的单位和FOREVER返回false。
    
    Specified by:
    
    isDateBased在界面 TemporalUnit
    
    结果
    
    如果是日期单位，则为真，如果为单位则为假
  - isTimeBased
```
public boolean isTimeBased()
```
    检查本机是否是时间单位。
    从纳米到半天的所有单位都是基于时间的。基于日期的单位和FOREVER返回false。
    
    Specified by:
    
    isTimeBased在接口 TemporalUnit
    
    结果
    
    如果一个时间单位是真的，如果一个日期单位是假的
  - isSupportedBy
```
public boolean isSupportedBy(Temporal temporal)
```
    说明从界面： TemporalUnit复制
    
    检查本机是否受指定的时间对象的支持。
    这检查实施日期时间可以加/减这个单位。这可以用来避免抛出异常。
    
    此默认实现使用Temporal.plus(long, TemporalUnit)导出值。
    
    Specified by:
    
    isSupportedBy在界面 TemporalUnit
    
    参数
    
    temporal - 要检查的时间对象，不为空
    
    结果
    
    如果设备支持，则为true
  - addTo
```
public <R extends Temporal> R addTo(R temporal,
                                    long amount)
```
    说明从界面： TemporalUnit复制
    返回添加指定句点的指定时间对象的副本。
    增加的时间是这个单位的倍数。例如，通过在表示“days”的实例上调用该方法，传递日期和期间“3”，可以使用此方法添加“3天”。要添加的时间可以是负数，这相当于减法。
    
    使用这种方法有两种等效的方法。第一个是直接调用这个方法。二是使用Temporal.plus(long, TemporalUnit) ：
```
  // these two lines are equivalent, but the second approach is recommended
   temporal = thisUnit.addTo(temporal);
   temporal = temporal.plus(thisUnit); 
```
    建议使用第二种方法， plus(TemporalUnit) ，因为在代码中阅读更清楚。
    实现应该执行使用可用的单位有任何疑问或计算ChronoUnit或可用字段ChronoField 。如果不支持该单元，则必须抛出UnsupportedTemporalTypeException 。
    
    实现不能改变指定的时间对象。相反，必须退还原件的调整副本。这为不可变和可变的实现提供了相当的安全行为。
    Specified by:
    
    addTo在界面 TemporalUnit
    
    参数类型
    
    R - 时间对象的类型
    
    参数
    
    temporal - 要调整的时间对象，不为空
    
    amount - 此单位的数量，正或负
    
    结果
    
    调整后的时间对象，不为空
  - between
```
public long between(Temporal temporal1Inclusive,
                    Temporal temporal2Exclusive)
```
    说明从界面： TemporalUnit复制
    计算两个时间对象之间的时间量。
    这计算出这个单位的数量。起始点和终点作为时间对象提供，并且必须是兼容类型。实施将在计算数量之前将第二类型转换为第一类的实例。如果结束在开始之前，结果将为负数。例如，可以使用HOURS.between(startTime, endTime)两个时间对象之间的小时数。
    
    计算返回一个整数，表示两个时间之间的完整单位数。例如，11时30分至13时29分之间的小时数将只有1小时，因为距离两小时不到1分钟。
    
    使用这种方法有两种等效的方法。第一个是直接调用这个方法。二是使用Temporal.until(Temporal, TemporalUnit) ：
```
  // these two lines are equivalent
   between = thisUnit.between(start, end);
   between = start.until(end, thisUnit); 
```
    应该根据这种做法进行选择，使代码更易读。
    例如，该方法允许计算两个日期之间的天数：
```
  long daysBetween = DAYS.between(start, end);
  // or alternatively
  long daysBetween = start.until(end, DAYS); 
```
    实现应该执行使用可用的单位有任何疑问或计算ChronoUnit或可用字段ChronoField 。如果不支持本机，则必须抛出UnsupportedTemporalTypeException 。实现不能改变指定的时间对象。
    Specified by:
    
    between在接口 TemporalUnit
    
    参数
    
    temporal1Inclusive - 基础时间对象，不为null
    
    temporal2Exclusive - 其他时间对象，排他，非空
    
    结果
    
    在本单位之间的temporal1Inclusive和temporal2独家之间的时间量; 如果temporal2Exclusive晚于temporal1Inclusive，则为正，如果更早则为负
  - toString
```
public String toString()
```
    描述从类别： Enum复制
    
    返回声明中包含的此枚举常量的名称。该方法可以被覆盖，尽管它通常不是必需或不可取的。当一个更“程序员友好”的字符串形式存在时，枚举类型应该覆盖此方法。
    
    Specified by:
    
    toString在界面 TemporalUnit
    
    重写：
    
    toString在 Enum<ChronoUnit>
    
    结果
    
    这个枚举常数的名称

Enum ChronoUnit

Enum Constant Summary

方法摘要

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

NANOS

MICROS

MILLIS

SECONDS

MINUTES

HOURS

HALF_DAYS

DAYS

WEEKS

MONTHS

YEARS

DECADES

CENTURIES

MILLENNIA

ERAS

FOREVER

方法详细信息

values

valueOf

getDuration

isDurationEstimated

isDateBased

isTimeBased

isSupportedBy

addTo

between

toString