模块  java.base
软件包  java.time.chrono

Class JapaneseEra

  • 实现的所有接口
    Serializable ， Era ， TemporalAccessor ， TemporalAdjuster 
    public final class JapaneseEraextends Objectimplements Era, Serializable
    日本帝国历法系统的一个时代。

    该类定义了日本年表的有效时代。 日本从明治6开始引入公历。只支持明治及后来的时代; 不支持1月1日明治6日之前的日期。

    实现要求：
    这个类是不可变的和线程安全的。
    从以下版本开始：
    1.8
    另请参见：
    Serialized Form

    • 字段详细信息

      • 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)
        获取这个时代的文本表示。

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

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

        Specified by:
        getDisplayName在界面 Era
        参数
        style - 所需文本的样式，不为null
        locale - 要使用的语言环境，而不是null
        结果
        时代的文本价值，不是空的

      • 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作为参数。 是否可以获得范围由该字段确定。

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

        Specified by:
        range接口 Era
        Specified by:
        range在界面 TemporalAccessor
        参数
        字段 - 要查询范围的字段，而不是null
        结果
        字段的有效值范围，不为null
        异常
        DateTimeException - 如果无法获得该字段的范围
        UnsupportedTemporalTypeException - 如果不支持该装置