Era (Java Platform SE 8 )

All Superinterfaces:

TemporalAccessor， TemporalAdjuster

所有已知实现类：

HijrahEra， IsoEra， JapaneseEra， MinguoEra， ThaiBuddhistEra
```
public interface Era
extends TemporalAccessor, TemporalAdjuster
```
一个时间线的时代。
大多数日历系统有一个单一的时代划分的时间线分为两个时代。然而，一些日历系统，有多个时代，如一个为每个领导者的统治。在所有情况下，时代是概念上最大的划分的时间线。每个年代的时代的定义是时代和Chronology.eras得到有效的时代。

例如，泰国佛教历法系统把时间分为两个时代，在一个单一的日期之前和之后。相比之下，日本历法系统有一个时代为每个皇帝的统治。

Era实例可以使用==算子相比。

实现要求：

此接口必须小心地执行，以确保其他类正确操作。所有的实现必须是单身-最终，不变的，线程安全的。建议尽可能使用枚举。

从以下版本开始：

一点八

方法摘要

所有方法接口方法抽象方法 Default Methods
Modifier and Type	Method and Description
`default Temporal`	`adjustInto(Temporal temporal)` 调整指定的时间对象，以具有相同的时代为这个对象。
`default int`	`get(TemporalField field)` 获取指定字段的值，从这个时代作为一个 `int`。
`default String`	`getDisplayName(TextStyle style, Locale locale)` 获取这个时代的文本表示。
`default long`	`getLong(TemporalField field)` 获取指定字段的值，从这个时代的一种 `long`。
`int`	`getValue()` 获取与所定义的时代相关联的数字值。
`default boolean`	`isSupported(TemporalField field)` 检查指定字段是否被支持。
`default <R> R`	`query(TemporalQuery<R> query)` 使用指定的查询查询这个时代。
`default ValueRange`	`range(TemporalField field)` 获取指定字段的有效值的范围。

- 方法详细信息
  - getValue
```
int getValue()
```
    获取与所定义的时代相关联的数字值。每个年代都定义了预定义的时代和方法来列出年代的年代。
    所有字段，包括时代，都有一个相关的数字值。时代的数字价值的含义是根据这些原则的时间顺序来确定的：
    - 在这个时代1970-01-01使用时代（ISO）的值为1。
    - 后来的时代有了更高的价值。
    - 较早的时代有顺序较低的值，这可能是负面的。
    结果
    
    数字时代价值
  - isSupported
```
default boolean isSupported(TemporalField field)
```
    检查指定字段是否被支持。
    此检查，如果这个时代可以查询指定的字段。如果为false，则调用range和get方法将抛出一个异常。
    
    如果该字段是ChronoField然后查询执行。的ERA场返回true。所有其他ChronoField实例将返回false。
    
    如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.isSupportedBy(TemporalAccessor)得到此方法的结果。是否支持字段由字段确定。
    
    Specified by:
    
    isSupported 接口 TemporalAccessor
    
    参数
    
    field -现场检查null返回false
    
    结果
    
    如果这个时代的领域是支持的，是假的，如果不是
  - range
```
default ValueRange range(TemporalField field)
```
    获取指定字段的有效值的范围。
    该范围对象表示字段的最小值和最大有效值。这个时代是用来提高返回范围的准确性。如果它是不可能返回的范围，因为字段不支持或其他一些原因，抛出一个异常。
    
    如果该字段是ChronoField然后查询执行。的ERA退货范围。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。
    
    如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.rangeRefinedBy(TemporalAccessor)得到此方法的结果。是否可以得到范围是由字段确定的。
    
    默认的实现必须返回从零到一个范围ERA，适合两历系统如ISO。
    
    Specified by:
    
    range 接口 TemporalAccessor
    
    参数
    
    field -现场查询范围，不为空
    
    结果
    
    字段的有效值的范围，而不是空值
    
    异常
    
    DateTimeException如果不能得到的领域范围
    
    UnsupportedTemporalTypeException如果单位不支持
  - get
```
default int get(TemporalField field)
```
    获取指定字段的值，从这个时代作为一个 int。
    这个查询这个时代为指定字段的值。返回的值将始终在字段的有效值范围内。如果不可能返回值，因为字段不支持或其他原因，则抛出异常。
    
    如果该字段是ChronoField然后查询执行。的ERA字段返回的时代价值。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。
    
    如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.getFrom(TemporalAccessor)得到此方法的结果。是否可以得到值，以及值表示的值，由字段确定。
    
    Specified by:
    
    get 接口 TemporalAccessor
    
    参数
    
    field -领域有，不空
    
    结果
    
    字段的值
    
    异常
    
    DateTimeException如果字段的值是不能获得或值不在字段的有效值范围内
    
    UnsupportedTemporalTypeException -如果字段不支持或值的范围超过一个 int
    
    ArithmeticException如果数值溢出时
  - getLong
```
default long getLong(TemporalField field)
```
    获取指定字段的值，从这个时代的一种 long。
    这个查询这个时代为指定字段的值。如果不可能返回值，因为字段不支持或其他原因，则抛出异常。
    
    如果该字段是ChronoField然后查询执行。的ERA字段返回的时代价值。所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException。
    
    如果该字段是不是ChronoField，然后通过调用作为参数传递this TemporalField.getFrom(TemporalAccessor)得到此方法的结果。是否可以得到值，以及值表示的值，由字段确定。
    
    Specified by:
    
    getLong 接口 TemporalAccessor
    
    参数
    
    field -领域有，不空
    
    结果
    
    字段的值
    
    异常
    
    DateTimeException如果不能得到一个价值领域
    
    UnsupportedTemporalTypeException如果字段不支持
    
    ArithmeticException如果数值溢出时
  - query
```
default <R> R query(TemporalQuery<R> query)
```
    使用指定的查询查询这个时代。
    这将使用指定的查询策略对象查询这个时代。的TemporalQuery对象定义了用来获得结果的逻辑。阅读查询的文档，了解该方法的结果将是什么。
    
    这种方法的结果是通过调用指定的查询通过this作为论据的TemporalQuery.queryFrom(TemporalAccessor)方法得到的。
    
    Specified by:
    
    query 接口 TemporalAccessor
    
    参数类型
    
    R -结果的类型
    
    参数
    
    query -调用查询，不空
    
    结果
    
    查询结果，可以返回（由查询所定义）
    
    异常
    
    DateTimeException如果无法查询（查询所定义）
    
    ArithmeticException如果数值溢出时（由查询定义）
  - adjustInto
```
default Temporal adjustInto(Temporal temporal)
```
    调整指定的时间对象，以具有相同的时代为这个对象。
    这将返回一个相同的可观察类型的时间对象，随着时代的变化，这是相同的。
    
    调整是相当于用Temporal.with(TemporalField, long)传递ChronoField.ERA作为现场。
    
    在大多数情况下，更清晰的用Temporal.with(TemporalAdjuster)反向调用模式：
```
这两条线是等价的，但第二种方法是建议时间=时代adjustinto（时间）；时间=时间，（时代）；
```
    此实例是不可变的，不受此方法调用的影响。
    Specified by:
    
    adjustInto 接口 TemporalAdjuster
    
    参数
    
    temporal -调整目标对象，不为空
    
    结果
    
    调整后的对象，而不是空
    
    异常
    
    DateTimeException如果无法适应
    
    ArithmeticException如果数值溢出时
  - getDisplayName
```
default String getDisplayName(TextStyle style,
                              Locale locale)
```
    获取这个时代的文本表示。
    这返回用于标识时代的文本名称，适合向用户演示。参数控制返回的文本和区域设置的样式。
    
    如果没有文本映射找到那么numeric value返回。
    
    此默认实现适用于所有实现。
    
    参数
    
    style -文本所需的风格，不要空
    
    locale -现场使用，不为空
    
    结果
    
    时代的文本价值，而不是零

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface Era

方法摘要

方法详细信息

getValue

isSupported

range

get

getLong

query

adjustInto

getDisplayName