Module java.base
Package java.time.chrono

Class MinguoChronology

java.lang.Object
java.time.chrono.AbstractChronology
java.time.chrono.MinguoChronology
所有已实现的接口:
Serializable, Comparable<Chronology>, Chronology
public final class MinguoChronology extends AbstractChronology implements Serializable
民国历系统。

该年表定义了民国历系统的规则。该历法系统主要在中华民国（通常称为台湾）使用。日期对齐，使得0001-01-01（民国历）等于1912-01-01（ISO）。

字段定义如下：

  • 纪元 - 有两个纪元，当前的“共和”（ERA_ROC）和之前的纪元（ERA_BEFORE_ROC）。
  • 年份 - 当前纪元的年份从第一年的纪元开始均匀增加。对于之前的纪元，随着时间倒退，年份从一开始增加。当前纪元的值等于ISO推测年减去1911。
  • 推测年 - 推测年与当前纪元的年份相同。对于之前的纪元，年份为零，然后为负值。该值等于ISO推测年减去1911。
  • 年份中的月份 - 民国历的年份中的月份与ISO完全匹配。
  • 月份中的日期 - 民国历的月份中的日期与ISO完全匹配。
  • 年份中的日期 - 民国历的年份中的日期与ISO完全匹配。
  • 闰年 - 民国历的闰年模式与ISO完全匹配，使得这两个日历永远不会脱节。
实现要求:
该类是不可变且线程安全的。
自 JDK 版本:
1.8
参见:

  • Field Details

    • INSTANCE

      public static final MinguoChronology INSTANCE
      民国历年表的单例实例。

  • Method Details

    • getId

      public String getId()
      获取年表的 ID - 'Minguo'。

      ID唯一标识Chronology。可以使用它来查找Chronology，方法是使用Chronology.of(String)。

      指定者:
      getId 在接口 Chronology中
      返回:
      年表 ID - 'Minguo'
      参见:

    • getCalendarType

      public String getCalendarType()
      获取基础日历系统的日历类型 - 'roc'。

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

      指定者:
      getCalendarType 在接口 Chronology中
      返回:
      日历系统类型 - 'roc'
      参见:

    • date

      public MinguoDate date(Era era, int yearOfEra, int month, int dayOfMonth)
      从纪元、年份中的年份、月份中的月份和日期中获取民国历日历系统中的本地日期。
      指定者:
      date 在接口 Chronology中
      参数:
      era - 民国纪元，非空
      yearOfEra - 年份
      month - 月份
      dayOfMonth - 日期
      返回:
      民国本地日期，非空
      抛出:
      DateTimeException - 如果无法创建日期
      ClassCastException - 如果era不是MinguoEra

    • date

      public MinguoDate date(int prolepticYear, int month, int dayOfMonth)
      从推测年、月份和日期中获取民国历日历系统中的本地日期。
      指定者:
      date 在接口 Chronology中
      参数:
      prolepticYear - 推测年
      month - 月份
      dayOfMonth - 日期
      返回:
      民国本地日期，非空
      抛出:
      DateTimeException - 如果无法创建日期

    • dateYearDay

      public MinguoDate dateYearDay(Era era, int yearOfEra, int dayOfYear)
      从纪元、年份中的年份和年份中的日期中获取民国历日历系统中的本地日期。
      指定者:
      dateYearDay 在接口 Chronology中
      参数:
      era - 民国纪元，非空
      yearOfEra - 年份
      dayOfYear - 年中的日期
      返回:
      民国本地日期，非空
      抛出:
      DateTimeException - 如果无法创建日期
      ClassCastException - 如果era不是MinguoEra

    • dateYearDay

      public MinguoDate dateYearDay(int prolepticYear, int dayOfYear)
      从推测年和年份中的日期中获取民国历日历系统中的本地日期。
      指定者:
      dateYearDay 在接口 Chronology中
      参数:
      prolepticYear - 推测年
      dayOfYear - 年中的日期
      返回:
      民国本地日期，非空
      抛出:
      DateTimeException - 如果无法创建日期

    • dateEpochDay

      public MinguoDate dateEpochDay(long epochDay)
      从纪元日获取民国历日历系统中的本地日期。
      指定者:
      dateEpochDay 在接口 Chronology中
      参数:
      epochDay - 纪元日
      返回:
      民国本地日期，非空
      抛出:
      DateTimeException - 如果无法创建日期

    • dateNow

      public MinguoDate dateNow()
      从接口复制的描述: Chronology
      从默认时区中的系统时钟获取该年表中的当前本地日期。

      这将查询默认时区中的系统时钟以获取当前日期。

      使用此方法将阻止使用替代时钟进行测试，因为时钟是硬编码的。

      指定者:
      dateNow 在接口 Chronology中
      返回:
      使用系统时钟和默认时区的当前本地日期，非空

    • dateNow

      public MinguoDate dateNow(ZoneId zone)
      从接口复制的描述： 年表
      从指定时区的系统时钟获取此年表中的当前本地日期。

      这将查询系统时钟以获取当前日期。指定时区可以避免依赖默认时区。

      使用此方法将阻止使用替代时钟进行测试，因为时钟是硬编码的。

      指定者：
      dateNow 在接口 年表
      参数：
      zone - 要使用的区域ID，不能为空
      返回：
      使用系统时钟的当前本地日期，不能为空

    • dateNow

      public MinguoDate dateNow(Clock clock)
      从接口复制的描述： 年表
      从指定时钟获取此年表中的当前本地日期。

      这将查询指定的时钟以获取当前日期 - 今天。使用此方法允许使用替代时钟进行测试。可以通过依赖注入引入替代时钟。

      指定者：
      dateNow 在接口 年表
      参数：
      clock - 要使用的时钟，不能为空
      返回：
      当前本地日期，不能为空

    • date

      public MinguoDate date(TemporalAccessor temporal)
      从接口复制的描述： 年表
      从另一个时间对象获取此年表中的本地日期。

      根据指定的时间对象在此年表中获取日期。 TemporalAccessor表示一组任意的日期和时间信息，此工厂将其转换为ChronoLocalDate的实例。

      转换通常使用EPOCH_DAY字段，该字段在日历系统中是标准化的。

      此方法与函数接口TemporalQuery的签名匹配，允许通过方法引用aChronology::date将其用作查询。

      指定者：
      date 在接口 年表
      参数：
      temporal - 要转换的时间对象，不能为空
      返回：
      此年表中的本地日期，不能为空
      参见：

    • localDateTime

      public ChronoLocalDateTime<MinguoDate> localDateTime(TemporalAccessor temporal)
      从接口复制的描述： 年表
      从另一个时间对象获取此年表中的本地日期时间。

      根据指定的时间对象在此年表中获取日期时间。 TemporalAccessor表示一组任意的日期和时间信息，此工厂将其转换为ChronoLocalDateTime的实例。

      转换提取并组合时间对象中的ChronoLocalDate和LocalTime。允许实现执行优化，例如访问等效于相关对象的字段。结果使用此年表。

      此方法与函数接口TemporalQuery的签名匹配，允许通过方法引用aChronology::localDateTime将其用作查询。

      指定者：
      localDateTime 在接口 年表
      参数：
      temporal - 要转换的时间对象，不能为空
      返回：
      此年表中的本地日期时间，不能为空
      参见：

    • zonedDateTime

      public ChronoZonedDateTime<MinguoDate> zonedDateTime(TemporalAccessor temporal)
      从接口复制的描述： 年表
      从另一个时间对象获取此年表中的ChronoZonedDateTime。

      根据指定的时间对象在此年表中获取带时区的日期时间。 TemporalAccessor表示一组任意的日期和时间信息，此工厂将其转换为ChronoZonedDateTime的实例。

      转换将首先从时间对象获取ZoneId，必要时回退到ZoneOffset。然后尝试获取Instant，必要时回退到ChronoLocalDateTime。结果将是ZoneId或ZoneOffset与Instant或ChronoLocalDateTime的组合。允许实现执行优化，例如访问等效于相关对象的字段。结果使用此年表。

      此方法与函数接口TemporalQuery的签名匹配，允许通过方法引用aChronology::zonedDateTime将其用作查询。

      指定者：
      zonedDateTime 在接口 年表
      参数：
      temporal - 要转换的时间对象，不能为空
      返回：
      此年表中的带时区的日期时间，不能为空
      参见：

    • zonedDateTime

      public ChronoZonedDateTime<MinguoDate> zonedDateTime(Instant instant, ZoneId zone)
      从接口复制的描述： 年表
      从Instant获取此年表中的ChronoZonedDateTime。

      获取具有与指定时间相同的即时的带时区的日期时间。

      指定者：
      zonedDateTime 在接口 年表
      参数：
      instant - 创建日期时间的即时，不能为空
      zone - 时区，不能为空
      返回：
      带时区的日期时间，不能为空

    • isLeapYear

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

      民国闰年与ISO闰年完全一致。此方法不验证传入的年份，并且仅对支持范围内的年份有明确定义的结果。

      指定者：
      isLeapYear 在接口 年表
      参数：
      prolepticYear - 要检查的纪年，未验证范围
      返回：
      如果年份是闰年，则为true

    • prolepticYear

      public int prolepticYear(Era era, int yearOfEra)
      从接口复制的描述： 年表
      根据纪元和纪元年计算纪年。

      将纪元和纪元年组合成单个纪年字段。

      如果年表积极使用纪元，例如JapaneseChronology，则将根据纪元验证年元。对于其他年表，验证是可选的。

      指定者：
      prolepticYear 在接口 年表
      参数：
      era - 与年表类型相符的纪元，不能为空
      yearOfEra - 年表纪元年
      返回：
      纪年

    • eraOf

      public MinguoEra eraOf(int eraValue)
      从接口复制的描述： 年表
      根据数字值创建年表纪元对象。

      纪元在概念上是时间线的最大划分。大多数日历系统有一个将时间线分为两个纪元的单个纪元。但是，有些日历系统有多个纪元，例如每位领导人的统治一个。确切的含义由年表根据以下约束确定。

      1970-01-01使用的纪元值必须为1。后续纪元必须具有依次更高的值。较早的纪元必须具有依次更低的值。每个年表必须引用一个枚举或类似的单例以提供纪元值。

      此方法返回指定纪元值的正确类型的单例纪元。

      指定者：
      eraOf 在接口 年表
      参数：
      eraValue - 纪元值
      返回：
      日历系统纪元，不能为空

    • eras

      public List<Era> eras()
      从接口复制的描述： 年表
      获取年表的时代列表。

      大多数日历系统都有一个时代，其中年份具有意义。如果日历系统不支持时代的概念，则必须返回一个空列表。

      指定者：
      eras 在接口 Chronology
      返回值：
      年表的时代列表，可能是不可变的，不能为空

    • range

      public ValueRange range(ChronoField field)
      从接口复制的描述： 年表
      获取指定字段的有效值范围。

      所有字段都可以表示为一个long整数。此方法返回一个描述该值有效范围的对象。

      请注意，结果仅描述最小和最大有效值，重要的是不要读取太多内容。例如，范围内可能存在对于该字段无效的值。

      无论年表是否支持该字段，此方法都将返回结果。

      指定者：
      range 在接口 Chronology
      参数：
      field - 要获取范围的字段，不能为空
      返回值：
      字段的有效值范围，不能为空

    • resolveDate

      public MinguoDate resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)
      从类复制的描述： AbstractChronology
      在解析期间将解析的ChronoField值解析为日期。

      大多数TemporalField实现都使用字段上的解析方法进行解析。相比之下，ChronoField类定义了仅相对于年表具有意义的字段。因此，在此处解析ChronoField日期字段是在特定年表的上下文中解析的。

      此方法通过此方法解析ChronoField实例，可以在子类中重写。

      • EPOCH_DAY - 如果存在，则将其转换为日期，然后将所有其他日期字段与日期进行交叉检查。
      • PROLEPTIC_MONTH - 如果存在，则将其拆分为YEAR和MONTH_OF_YEAR。如果模式是严格或智能，则将验证该字段。
      • YEAR_OF_ERA和ERA - 如果两者都存在，则将它们组合形成一个YEAR。在宽松模式下，不会验证YEAR_OF_ERA范围，在智能和严格模式下会验证。在所有三种模式下，将验证ERA的范围。如果只有YEAR_OF_ERA存在，并且模式是智能或宽松，则假定最后一个可用的时代。在严格模式下，不会假定任何时代，而会保持YEAR_OF_ERA不变。如果只有ERA存在，则会保持不变。
      • YEAR、MONTH_OF_YEAR和DAY_OF_MONTH - 如果三者都存在，则将它们组合形成一个日期。在所有三种模式下，将验证YEAR。如果模式是智能或严格，则将验证月份和日期。如果模式是宽松的，则将日期组合成等同于在请求的年份的第一个月的第一天创建日期，然后添加月份的差异，然后添加天数的差异的方式。如果模式是智能的，并且日期大于年月的最大日期，则将日期调整为最后一天。如果模式是严格的，则这三个字段必须形成有效日期。
      • YEAR和DAY_OF_YEAR - 如果两者都存在，则将它们组合形成一个日期。在所有三种模式下，将验证YEAR。如果模式是宽松的，则将日期组合成等同于在请求的年份的第一天创建日期，然后添加天数的差异。如果模式是智能或严格的，则这两个字段必须形成有效日期。
      • YEAR、MONTH_OF_YEAR、ALIGNED_WEEK_OF_MONTH和ALIGNED_DAY_OF_WEEK_IN_MONTH - 如果四者都存在，则将它们组合形成一个日期。在所有三种模式下，将验证YEAR。如果模式是宽松的，则将日期组合成等同于在请求的年份的第一个月的第一天创建日期，然后添加月份的差异，然后添加周数的差异，然后添加天数的差异。如果模式是智能或严格的，则将验证所有四个字段的外部范围。然后，日期将以等同于在请求的年份和月份的第一天创建日期的方式组合，然后添加周数和天数以达到它们的值。如果模式是严格的，则还将验证日期以检查日期和周调整是否更改了月份。
      • YEAR、MONTH_OF_YEAR、ALIGNED_WEEK_OF_MONTH和DAY_OF_WEEK - 如果四者都存在，则将它们组合形成一个日期。对于年份、月份和周在ALIGNED_DAY_OF_WEEK_IN_MONTH中的处理方式与上述相同。一旦处理了年份、月份和周，就会调整星期几为下一个或相同匹配的星期几。
      • YEAR、ALIGNED_WEEK_OF_YEAR和ALIGNED_DAY_OF_WEEK_IN_YEAR - 如果三者都存在，则将它们组合形成一个日期。在所有三种模式下，将验证YEAR。如果模式是宽松的，则将日期组合成等同于在请求的年份的第一天创建日期，然后添加周数的差异，然后添加天数的差异。如果模式是智能或严格的，则将验证所有三个字段的外部范围。然后，日期将以等同于在请求的年份的第一天创建日期的方式组合，然后添加周数和天数以达到它们的值。如果模式是严格的，则还将验证日期以检查日期和周调整是否更改了年份。
      • YEAR、ALIGNED_WEEK_OF_YEAR和DAY_OF_WEEK - 如果三者都存在，则将它们组合形成一个日期。对于年份和周在ALIGNED_DAY_OF_WEEK_IN_YEAR中的处理方式与上述相同。一旦处理了年份和周，就会调整星期几为下一个或相同匹配的星期几。

      默认实现适用于大多数日历系统。如果找到ChronoField.YEAR_OF_ERA而没有ChronoField.ERA，则将使用Chronology.eras()中的最后一个时代。该实现假定一周为7天，每月的第一天值为1，每年的第一天值为1，并且每月和每年的第一天始终存在。

      指定者：
      resolveDate 在接口 Chronology
      覆盖：
      resolveDate 在类 AbstractChronology
      参数：
      fieldValues - 字段到值的映射，可以更新，不能为空
      resolverStyle - 请求的解析类型，不能为空
      返回值：
      解析后的日期，如果信息不足以创建日期则为null

    • isIsoBased

      public boolean isIsoBased()
      MinguoChronology是基于ISO的年表，支持IsoFields中的字段，例如DAY_OF_QUARTER和QUARTER_OF_YEAR。
      指定者：
      isIsoBased 在接口 Chronology
      返回值：
      true
      自：
      19
      参见：