- java.lang.Object
-
- java.time.chrono.JapaneseEra
-
- 实现的所有接口
-
Serializable
,Era
,TemporalAccessor
,TemporalAdjuster
public final class JapaneseEra extends Object implements Era, Serializable
日本帝国历法系统的一个时代。该类定义了日本年表的有效时代。 日本从明治6开始引入公历。只支持明治及后来的时代; 不支持1月1日明治6日之前的日期。
- 实现要求:
- 这个类是不可变的和线程安全的。
- 从以下版本开始:
- 1.8
- 另请参见:
- Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 static JapaneseEra
HEISEI
'平成'时代(1989-01-08 - 2019-04-30)的单例实例,其值为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。
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 String
getDisplayName(TextStyle style, Locale locale)
获取这个时代的文本表示。int
getValue()
获取数字时代int
值。static JapaneseEra
of(int japaneseEra)
从int
值获得JapaneseEra
的实例。ValueRange
range(TemporalField field)
获取指定字段的有效值范围。static JapaneseEra
valueOf(String japaneseEra)
返回名称为JapaneseEra
。static JapaneseEra[]
values()
返回JapaneseEras数组。-
声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
声明方法的接口 java.time.chrono.Era
adjustInto, get, 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 - 2019-04-30)的单例实例,其值为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名字; 非空 - 结果
-
单身的
JapaneseEra
,永远不会为空 - 异常
-
IllegalArgumentException
- 如果没有具有指定名称的JapaneseEra
-
values
public static JapaneseEra[] values()
返回JapaneseEras数组。此方法可用于迭代JapaneseEras,如下所示:
for (JapaneseEra c : JapaneseEra.values()) System.out.println(c);
- 结果
- 日本的一系列日历
-
getDisplayName
public String getDisplayName(TextStyle style, Locale locale)
- Specified by:
-
getDisplayName
在界面Era
- 参数
-
style
- 所需文本的样式,不为null -
locale
- 要使用的语言环境,而不是null - 结果
- 时代的文本价值,不是空的
-
getValue
public int getValue()
-
range
public ValueRange range(TemporalField field)
获取指定字段的有效值范围。范围对象表示字段的最小和最大有效值。 这个时代用于提高返回范围的准确性。 如果无法返回范围,因为不支持该字段或由于某些其他原因,将引发异常。
如果该字段是
ChronoField
,则在此处实现查询。ERA
字段返回范围。 所有其他ChronoField
实例将抛出UnsupportedTemporalTypeException
。如果该字段是不是一个
ChronoField
,则此方法的结果是通过调用获得TemporalField.rangeRefinedBy(TemporalAccessor)
传递this
作为参数。 是否可以获得范围由该字段确定。由于日历系统的性质,日本有效时代的范围可能会随着时间而变化。
- Specified by:
-
range
接口Era
- Specified by:
-
range
在界面TemporalAccessor
- 参数
-
字段
- 要查询范围的字段,而不是null - 结果
- 字段的有效值范围,不为null
- 异常
-
DateTimeException
- 如果无法获得该字段的范围 -
UnsupportedTemporalTypeException
- 如果不支持该装置
-
-