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

Class JapaneseEra

  • 实现的所有接口
    SerializableEraTemporalAccessorTemporalAdjuster

    public final class JapaneseEra
    extends Object
    implements 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 - 如果不支持该装置