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

Class JapaneseChronology

  • 实现的所有接口
    Serializable ， Comparable<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