方法详细信息

• getValue

  int getValue()

  获取与年表定义的时代关联的数值。 每个年代表定义了预定义的Eras和列出年代时代的方法。

  所有字段（包括eras）都具有关联的数值。 时代的数值的含义由年表根据这些原则确定：

  • 在1970-01-01（ISO）时代使用的时代具有值1。
  • 后来的时代有着更高的价值。
  • 早期的时代有着较低的价值，这可能是负面的。

  结果

  数字时代价值

• isSupported

  default boolean isSupported​(TemporalField field)

  检查是否支持指定的字段。

  这将检查是否可以查询指定字段的时代。 如果为false，则调用range和get方法将引发异常。

  如果该字段是ChronoField，则在此处实现查询。 ERA字段返回true。 所有其他ChronoField实例将返回false。

  如果该字段不是ChronoField ，则通过调用TemporalField.isSupportedBy(TemporalAccessor)传递this作为参数来获得此方法的结果。 字段是否受支持由字段确定。

  Specified by:

  isSupported在界面 TemporalAccessor

  参数

  字段 - 要检查的字段，null返回false

  结果

  如果在这个时代支持该字段，则为true，否则为false

• range

  default ValueRange range​(TemporalField field)

  获取指定字段的有效值范围。

  范围对象表示字段的最小和最大有效值。 这个时代用于提高返回范围的准确性。 如果无法返回范围，因为不支持该字段或由于某些其他原因，将引发异常。

  如果该字段是ChronoField，则在此处执行查询。 ERA字段返回范围。 所有其他ChronoField实例将抛出UnsupportedTemporalTypeException 。

  如果该字段是不是一个ChronoField ，则此方法的结果是通过调用获得TemporalField.rangeRefinedBy(TemporalAccessor)传递this作为参数。 是否可以获得范围由该字段确定。

  默认实现必须将ERA的范围从零返回到1，适用于两个时代的日历系统，例如ISO。

  Specified by:

  range在界面 TemporalAccessor

  参数

  字段 - 要查询范围的字段，而不是null

  结果

  字段的有效值范围，不为null

  异常

  DateTimeException - 如果无法获得该字段的范围

  UnsupportedTemporalTypeException - 如果不支持该装置

• get

  default int get​(TemporalField field)

  获取此时代指定字段的值为int 。

  这会查询此时代的指定字段的值。 返回的值将始终在该字段的有效值范围内。 如果无法返回该值，因为不支持该字段或由于某些其他原因，将引发异常。

  如果该字段是ChronoField，则在此处实现查询。 ERA字段返回时代的值。 所有其他ChronoField实例将抛出UnsupportedTemporalTypeException 。

  如果该字段是不是一个ChronoField ，则此方法的结果是通过调用获得TemporalField.getFrom(TemporalAccessor)传递this作为参数。 是否可以获得该值以及该值表示的值由该字段确定。

  Specified by:

  get在界面 TemporalAccessor

  参数

  字段 - 要获取的字段，而不是null

  结果

  该字段的值

  异常

  DateTimeException - 如果无法获取该字段的值或该值超出该字段的有效值范围

  UnsupportedTemporalTypeException - 如果不支持该字段或值的范围超过 int

  ArithmeticException - 如果发生数字溢出

• getLong

  default long getLong​(TemporalField field)

  获取此时代指定字段的值为long 。

  这会查询此时代的指定字段的值。 如果无法返回该值，因为不支持该字段或由于某些其他原因，将引发异常。

  如果该字段是ChronoField，则在此处执行查询。 ERA字段返回时代的值。 所有其他ChronoField实例将抛出UnsupportedTemporalTypeException 。

  如果该字段不是ChronoField ，则通过调用TemporalField.getFrom(TemporalAccessor)传递this作为参数来获得此方法的结果。 是否可以获得该值以及该值表示的值由该字段确定。

  Specified by:

  getLong在界面 TemporalAccessor

  参数

  字段 - 要获取的字段，而不是null

  结果

  该字段的值

  异常

  DateTimeException - 如果无法获得该字段的值

  UnsupportedTemporalTypeException - 如果不支持该字段

  ArithmeticException - 如果发生数字溢出

• query

  default <R> R query​(TemporalQuery<R> query)

  使用指定的查询查询此时代。

  这使用指定的查询策略对象查询此时代。 TemporalQuery对象定义用于获取结果的逻辑。 阅读查询文档以了解此方法的结果。

  通过在指定的查询上调用TemporalQuery.queryFrom(TemporalAccessor)方法作为参数传递this来获得此方法的结果。

  Specified by:

  query接口 TemporalAccessor

  参数类型

  R - 结果的类型

  参数

  query - 要调用的查询，而不是null

  结果

  查询结果，可以返回null（由查询定义）

  异常

  DateTimeException - 如果无法查询（由查询定义）

  ArithmeticException - 如果发生数字溢出（由查询定义）

• adjustInto

  default Temporal adjustInto​(Temporal temporal)

  调整指定的时态对象以使其与此对象具有相同的时代。

  这将返回与输入相同的可观察类型的时间对象，其中时代已更改为与此相同。

  该调整是相当于使用Temporal.with(TemporalField, long)传递ChronoField.ERA作为字段。

  在大多数情况下，使用Temporal.with(TemporalAdjuster)更清楚地反转调用模式：

    // these two lines are equivalent, but the second approach is recommended
     temporal = thisEra.adjustInto(temporal);
     temporal = temporal.with(thisEra); 

  此实例是不可变的，不受此方法调用的影响。

  Specified by:

  adjustInto接口 TemporalAdjuster

  参数

  temporal - 要调整的目标对象，而不是null

  结果

  调整后的对象，不为空

  异常

  DateTimeException - 如果无法进行调整

  ArithmeticException - 如果发生数字溢出

• getDisplayName

  default String getDisplayName​(TextStyle style,
                                Locale locale)

  获取这个时代的文本表示。

  这将返回用于标识时代的文本名称，适合呈现给用户。 参数控制返回文本的样式和区域设置。

  如果未找到文本映射，则返回numeric value 。

  API Note:

  此默认实现适用于大多数实现。

  参数

  style - 所需文本的样式，不为null

  locale - 要使用的语言环境，而不是null

  结果

  时代的文本价值，不是空的