compact1, compact2, compact3

java.time.chrono

Class JapaneseEra

java.lang.Object

java.time.chrono.JapaneseEra

All Implemented Interfaces:

Serializable ， Era ， TemporalAccessor ， TemporalAdjuster

public final class JapaneseEra
extends Object
implements Era, Serializable

日本帝国日历系统的时代。

这个类定义了日本年代的有效时代。 日本介绍了从明治6开始的公历。只有明治和以后的时代得到支持; 1月1日明治6日之前的日期不受支持。

实现要求：

这个类是不可变的和线程安全的。

从以下版本开始：

1.8

另请参见：

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static JapaneseEra	HEISEI “平成”时代（1989-01-08 - 现在）的单身人士，其价值为2。
static JapaneseEra	MEIJI “明治”时代（1868-01-01 - 1912-07-29）的单身实例，其值为-1。
static JapaneseEra	SHOWA “昭和”时代（1926-12-25 - 1989-01-07）的单身实例，价值1。
static JapaneseEra	TAISHO “大正”时代（1912-07-30 - 1926-12-24）的单身人士的例子为0。

方法摘要

Modifier and Type	Method and Description
int	getValue() 获得数字时代 int价值。
static JapaneseEra	of(int japaneseEra) 从 int获得 JapaneseEra一个实例。
ValueRange	range(TemporalField field) 获取指定字段的有效值的范围。
String	toString() 返回对象的字符串表示形式。
static JapaneseEra	valueOf(String japaneseEra) 返回名称为 JapaneseEra 。
static JapaneseEra[]	values() 返回一个JapaneseEras数组。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.time.chrono.Era

adjustInto, get, getDisplayName, getLong, isSupported, query

字段详细信息

MEIJI

public static final JapaneseEra MEIJI

“明治”时代（1868-01-01 - 1912-07-29）的单身实例，其值为-1。

TAISHO

public static final JapaneseEra TAISHO

“大正”时代（1912-07-30 - 1926-12-24）的单身人士的例子为0。

SHOWA

public static final JapaneseEra SHOWA

“昭和”时代（1926-12-25 - 1989-01-07）的单身实例，价值1。

HEISEI

public static final JapaneseEra HEISEI

“平成”时代（1989-01-08 - 现在）的单身人士，其价值为2。

方法详细信息

of

public static JapaneseEra of(int japaneseEra)

从int获得JapaneseEra一个实例。

包含1970-01-01（ISO日历系统）的SHOWA时代的价值1后来的时代编号为2（ HEISEI ）。 较早的时代编号为0（ TAISHO ），-1（ MEIJI ），仅支持明治及以后的时代。

参数

japaneseEra - 代表的时代

结果

JapaneseEra单身人士，不为空

异常

DateTimeException - 如果值无效

valueOf

public static JapaneseEra valueOf(String japaneseEra)

返回名称为JapaneseEra 。

字符串必须与时代的名称完全一致。 （不允许使用外来空白字符。）

参数

japaneseEra - 日本名称; 非空

结果

JapaneseEra单身人士，从不为空

异常

IllegalArgumentException - 如果没有指定名称的JapaneseEra

values

public static JapaneseEra[] values()

返回一个JapaneseEras数组。

这种方法可以用来遍历JapanEras，如下所示：

  for (JapaneseEra c : JapaneseEra.values())
     System.out.println(c); 

结果

一系列日本人

getValue

public int getValue()

获取数值时代int价值。

包含1970-01-01（ISO日历系统）的SHOWA时代的值为1.后来的时间从2（ HEISEI ）编号。 较早的时代编号为0（ TAISHO ），-1（ MEIJI ））。

Specified by:

getValue在界面 Era

结果

时代价值

range

public ValueRange range(TemporalField field)

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

范围对象表示字段的最小和最大有效值。 这个时代用来提高返回范围的准确性。 如果不可能返回范围，因为该字段不受支持或出于某种其他原因，则抛出异常。

如果该字段是ChronoField，那么查询是在这里实现的。 ERA字段返回范围。 所有其他ChronoField实例将抛出一个UnsupportedTemporalTypeException 。

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

由于日本日历系统的性质，日本有效期的范围可能会随时间而变化。

Specified by:

range在接口 Era

Specified by:

range在界面 TemporalAccessor

参数

field - 查询范围的字段，不为null

结果

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

异常

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

UnsupportedTemporalTypeException - 如果不支持本机

toString

public String toString()

描述从类别复制： Object

返回对象的字符串表示形式。 一般来说， toString方法返回一个字符串，“文本地表示”这个对象。 结果应该是一个简明扼要的表达，容易让人阅读。 建议所有子类覆盖此方法。

该toString类方法Object返回一个由其中的对象是一个实例，该符号字符`的类的名称的字符串@ ”和对象的哈希码的无符号的十六进制表示。 换句话说，这个方法返回一个等于下列值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

重写：

toString在类别 Object

结果

a string representation of the object.