Module  java.base
软件包  java.time.chrono

Class 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

    • 字段详细信息

      • 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);
        结果
        一系列日本人

      • getDisplayName

        public String getDisplayName​(TextStyle style,
                             Locale locale)
        获得这个时代的文字表现。

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

        如果没有发现文本映射，则返回numeric value 。

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

      • 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
        参数
        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.