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

Class JapaneseChronology

  • 实现的所有接口
    SerializableComparable<Chronology>Chronology

    public final class JapaneseChronology
    extends AbstractChronology
    implements Serializable
    日本帝国的历法系统。

    这个年表定义了日本帝国日历系统的规则。 该日历系统主要在日本使用。 除了基于时代的年份编号之外,日本帝国日历系统与ISO日历系统相同。

    日本从明治6开始引入公历。只支持明治及后来的时代; 不支持1月1日明治6日之前的日期。

    支持的ChronoField实例是:

    • DAY_OF_WEEK
    • DAY_OF_MONTH
    • DAY_OF_YEAR
    • EPOCH_DAY
    • MONTH_OF_YEAR
    • PROLEPTIC_MONTH
    • YEAR_OF_ERA
    • YEAR
    • ERA
    实现要求:
    这个类是不可变的和线程安全的。
    从以下版本开始:
    1.8
    另请参见:
    Serialized Form
    • 字段详细信息

      • INSTANCE

        public static final JapaneseChronology INSTANCE
        Singleton实例为日本年表。
    • 方法详细信息

      • getCalendarType

        public String getCalendarType()
        获取基础日历系统的日历类型 - “japanese”。

        日历类型是由Unicode区域设置数据标记语言(LDML)规范定义的标识符。 它可用于查找Chronology使用Chronology.of(String) 它也可以用作语言环境的一部分,可通过Locale.getUnicodeLocaleType(String)使用键“ca”访问。

        Specified by:
        getCalendarType ,界面 Chronology
        结果
        日历系统类型 - 'japanese'
        另请参见:
        getId()
      • date

        public JapaneseDate date​(Era era,
                                 int yearOfEra,
                                 int month,
                                 int dayOfMonth)
        从日期,年份,月份和日期字段中获取日语日历系统中的本地日期。

        日语月份和日期与ISO日历系统中的相同。 当时代变化时,它们不会被重置。 例如:

          6th Jan Showa 64 = ISO 1989-01-06
          7th Jan Showa 64 = ISO 1989-01-07
          8th Jan Heisei 1 = ISO 1989-01-08
          9th Jan Heisei 1 = ISO 1989-01-09 
        Specified by:
        date in interface Chronology
        参数
        era - 日本时代,不是空的
        yearOfEra - 年代
        month - 该年的月份
        dayOfMonth - 每月的某天
        结果
        日本本地日期,不为空
        异常
        DateTimeException - 如果无法创建日期
        ClassCastException - 如果 era不是 JapaneseEra
      • date

        public JapaneseDate date​(int prolepticYear,
                                 int month,
                                 int dayOfMonth)
        从预测年,月份和日期字段获得日语日历系统中的本地日期。

        日本的早期,月份和日期与ISO日历系统中的相同。 当时代变化时,它们不会被重置。

        Specified by:
        date ,界面 Chronology
        参数
        prolepticYear - 这个 prolepticYear
        month - 该年的月份
        dayOfMonth - 每月的某天
        结果
        日本本地日期,不为空
        异常
        DateTimeException - 如果无法创建日期
      • dateYearDay

        public JapaneseDate dateYearDay​(Era era,
                                        int yearOfEra,
                                        int dayOfYear)
        从日期,年代和日期字段中获取日语日历系统中的本地日期。

        这家工厂的年份相对于年代的开始表示。 该定义仅在由于时代变化而将年代重置为1的年份中改变了日期的正常含义。 例如:

          6th Jan Showa 64 = day-of-year 6
          7th Jan Showa 64 = day-of-year 7
          8th Jan Heisei 1 = day-of-year 1
          9th Jan Heisei 1 = day-of-year 2 
        Specified by:
        dateYearDay ,界面 Chronology
        参数
        era - 日本时代,不是空的
        yearOfEra - 年代
        dayOfYear - 该年的一天
        结果
        日本本地日期,不为空
        异常
        DateTimeException - 如果无法创建日期
        ClassCastException - 如果 era不是 JapaneseEra
      • dateYearDay

        public JapaneseDate dateYearDay​(int prolepticYear,
                                        int dayOfYear)
        从预知年和日期字段获得日语日历系统中的本地日期。

        该工厂的年份相对于预感年份的开始表示。 日本的预感年份和日期与ISO日历系统中的相同。 当时代变化时,它们不会被重置。

        Specified by:
        dateYearDay接口 Chronology
        参数
        prolepticYear - prolepticYear
        dayOfYear - 这一天的日期
        结果
        日本本地日期,不为空
        异常
        DateTimeException - 如果无法创建日期
      • dateEpochDay

        public JapaneseDate dateEpochDay​(long epochDay)
        从纪元日起在日历日历系统中获得本地日期。
        Specified by:
        dateEpochDay in interface Chronology
        参数
        epochDay - 纪元日
        结果
        日本本地日期,不为空
        异常
        DateTimeException - 如果无法创建日期
      • isLeapYear

        public boolean isLeapYear​(long prolepticYear)
        检查指定年份是否为闰年。

        日历闰年与ISO闰年完全一致。 此方法不会验证传入的年份,并且仅在支持的范围内具有明确定义的结果。

        Specified by:
        isLeapYear在界面 Chronology
        参数
        prolepticYear - 需要检查的 prolepticYear年份,未经过有效范围验证
        结果
        如果年份是闰年,则为true