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

Class MinguoChronology

  • All Implemented Interfaces:
    SerializableComparable<Chronology>Chronology


    public final class MinguoChronology
    extends AbstractChronology
    implements Serializable
    国际日历系统。

    这个年表定义了Minguo日历系统的规则。 这个日历系统主要用于中华民国,通常被称为台湾。 日期对齐, 0001-01-01 (Minguo)1912-01-01 (ISO)

    字段定义如下:

    • 时代 - 有两个时代,现在的“共和国”(ERA_ROC)和前一个时代(ERA_BEFORE_ROC)。
    • 年代 - 当代时代的年代从一年的时代起统一起来。 对于前一个时代,一年中随着时间的推移而增加。 当前时代的价值等于ISO抗体年减去1911年。
    • 幼稚年份 - 幼稚年份与当今时代相同。 对于以前的时代,岁月有零,然后负值。 该值等于ISO抗精神病年减去1911年。
    • 月份 - Minguo月份与ISO完全匹配。
    • 月份 - Minguo日期与ISO完全匹配。
    • 日期 - Minguo的日期与ISO完全一致。
    • 闰年 - Minguo闰年模式与ISO完全匹配,使得两个日历永远不会失步。
    实现要求:
    这个类是不可变的和线程安全的。
    从以下版本开始:
    1.8
    另请参见:
    Serialized Form
    • 字段详细信息

      • INSTANCE

        public static final MinguoChronology INSTANCE
        孟国时代的单身人士实例。
    • 方法详细信息

      • getCalendarType

        public String getCalendarType​()
        获取底层日历系统的日历类型 - “roc”。

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

        Specified by:
        getCalendarType在接口 Chronology
        结果
        日历系统类型 - 'roc'
        另请参见:
        getId()
      • date

        public MinguoDate date​(Era era,
                               int yearOfEra,
                               int month,
                               int dayOfMonth)
        从时代,年龄,月份和月份的时代,获得Minguo日历系统中的当地日期。
        Specified by:
        date在接口 Chronology
        参数
        era - 金国时代,不为空
        yearOfEra - 年代
        month - 年月日
        dayOfMonth - 月的日子
        结果
        Minguo本地日期,不为null
        异常
        DateTimeException - 如果无法创建日期
        ClassCastException - 如果 era不是 MinguoEra
      • date

        public MinguoDate date​(int prolepticYear,
                               int month,
                               int dayOfMonth)
        从月光年,月和月的月份中获取Minguo日历系统中的当地日期。
        Specified by:
        date在接口 Chronology
        参数
        prolepticYear - prolepticYear
        month - 年月
        dayOfMonth - 月的日子
        结果
        Minguo本地日期,不为null
        异常
        DateTimeException - 如果无法创建日期
      • dateYearDay

        public MinguoDate dateYearDay​(Era era,
                                      int yearOfEra,
                                      int dayOfYear)
        从时代,年龄和日期领域获得Minguo日历系统中的当地日期。
        Specified by:
        dateYearDay在接口 Chronology
        参数
        era - era时代,不为空
        yearOfEra - 年代
        dayOfYear - 年的日子
        结果
        Minguo本地日期,不为null
        异常
        DateTimeException - 如果无法创建日期
        ClassCastException - 如果 era不是 MinguoEra
      • dateYearDay

        public MinguoDate dateYearDay​(int prolepticYear,
                                      int dayOfYear)
        从日光年和日期字段获取Minguo日历系统中的当地日期。
        Specified by:
        dateYearDay在接口 Chronology
        参数
        prolepticYear - prolepticYear
        dayOfYear - 一年的一天
        结果
        Minguo本地日期,不为null
        异常
        DateTimeException - 如果无法创建日期
      • dateEpochDay

        public MinguoDate dateEpochDay​(long epochDay)
        从时代到日本的Minguo日历系统获取本地日期。
        Specified by:
        dateEpochDay在接口 Chronology
        参数
        epochDay - 纪元日
        结果
        Minguo本地日期,不为null
        异常
        DateTimeException - 如果无法创建日期
      • dateNow

        public MinguoDate dateNow​()
        描述从接口Chronology复制
        从默认时区的系统时钟获取此时间顺序中的当前本地日期。

        这将查询默认时区中的system clock以获取当前日期。

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

        Specified by:
        dateNow在接口 Chronology
        结果
        当前本地日期使用系统时钟和默认时区,不为空
      • dateNow

        public MinguoDate dateNow​(ZoneId zone)
        说明从界面Chronology复制
        从指定时区的系统时钟获取此时间顺序中的当前本地日期。

        这将查询system clock获取当前日期。 指定时区可以避免对默认时区的依赖。

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

        Specified by:
        dateNow在接口 Chronology
        参数
        zone - 要使用的区域ID,不为空
        结果
        当前本地日期使用系统时钟,不为null
      • dateNow

        public MinguoDate dateNow​(Clock clock)
        说明从接口Chronology复制
        从指定的时钟获取本年龄的当前本地日期。

        这将查询指定的时钟以获取当前日期 - 今天。 使用此方法可以使用备用时钟进行测试。 备用时钟可以使用dependency injection引入。

        Specified by:
        dateNow在接口 Chronology
        参数
        clock - 要使用的时钟,不为空
        结果
        当前本地日期,不为null
      • date

        public MinguoDate date​(TemporalAccessor temporal)
        说明从界面Chronology复制
        从另一个时间对象获取本年龄的本地日期。

        这在这个时间表中基于指定的时间获得日期。 A TemporalAccessor表示日期和时间信息的任意集合,该工厂将转换为ChronoLocalDate的实例。

        转换通常使用EPOCH_DAY字段,该字段在日历系统之间进行标准化。

        该方法匹配功能界面TemporalQuery的签名,允许它通过方法参考aChronology::date作为查询使用。

        Specified by:
        date在接口 Chronology
        参数
        temporal - 要转换的时间对象,不为null
        结果
        这个年代的本地日期,不为空
        另请参见:
        ChronoLocalDate.from(TemporalAccessor)
      • localDateTime

        public ChronoLocalDateTime<MinguoDate> localDateTime​(TemporalAccessor temporal)
        说明从界面Chronology复制
        从另一个时间对象获取本年龄的本地日期时间。

        这在这个时间表中基于指定的时间获得日期时间。 A TemporalAccessor表示任意的日期和时间信息集,该工厂将转换为ChronoLocalDateTime的实例。

        转换提取并从时间对象中组合了ChronoLocalDateLocalTime 允许实现执行优化,例如访问与相关对象相当的那些字段。 结果使用这个年表。

        该方法匹配功能界面TemporalQuery的签名,允许其通过方法参考aChronology::localDateTime用作查询。

        Specified by:
        localDateTime在接口 Chronology
        参数
        temporal - 要转换的时间对象,不为空
        结果
        在这个年代的本地日期时间,不为空
        另请参见:
        ChronoLocalDateTime.from(TemporalAccessor)
      • zonedDateTime

        public ChronoZonedDateTime<MinguoDate> zonedDateTime​(TemporalAccessor temporal)
        说明从接口Chronology复制
        从另一个时间对象获得这个年龄的ChronoZonedDateTime

        根据指定的时间,在这个年表中获得一个分区的日期时间。 A TemporalAccessor表示日期和时间信息的任意集合,该工厂将其转换为ChronoZonedDateTime的实例。

        转换将首先从时间对象获取一个ZoneId ,如有必要,则返回到ZoneOffset 然后会尝试获得一个Instant ,如果需要的话可以回到ChronoLocalDateTime 结果将是ZoneIdZoneOffsetInstantChronoLocalDateTime 允许实现执行优化,例如访问与相关对象相当的那些字段。 结果使用这个年表。

        该方法匹配功能界面TemporalQuery的签名,允许其通过方法参考aChronology::zonedDateTime用作查询。

        Specified by:
        zonedDateTime在接口 Chronology
        参数
        temporal - 要转换的时间对象,不为null
        结果
        在这个年代的分区日期 - 时间,不为空
        另请参见:
        ChronoZonedDateTime.from(TemporalAccessor)
      • zonedDateTime

        public ChronoZonedDateTime<MinguoDate> zonedDateTime​(Instant instant,
                                                             ZoneId zone)
        描述从接口Chronology复制
        获得ChronoZonedDateTime在从这个年表Instant

        这将获得与指定的相同时间的分区日期时间。

        Specified by:
        zonedDateTime在接口 Chronology
        参数
        instant - 即时创建日期时间,不为null
        zone - 时区,不为空
        结果
        划分的日期时间,不为空
      • isLeapYear

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

        Minguo闰年完全符合ISO闰年。 该方法不能验证所传递的年份,并且在支持的范围内只有明确的结果多年。

        Specified by:
        isLeapYear在接口 Chronology
        参数
        prolepticYear - 检查年份,无法验证范围
        结果
        如果这一年是闰年,那么真的
      • prolepticYear

        public int prolepticYear​(Era era,
                                 int yearOfEra)
        说明从界面Chronology复制
        计算年龄和年龄的幼年时期。

        这将时代与时代融为一体的年轻一代。

        如果年表积极使用时代,如JapaneseChronology那么年龄将在时代得到验证。 对于其他年表,验证是可选的。

        Specified by:
        prolepticYear在接口 Chronology
        参数
        era - 时代的正确类型为年表,不为空
        yearOfEra - 年代的年代
        结果
        幼稚的一年
      • eraOf

        public MinguoEra eraOf​(int eraValue)
        描述从接口Chronology复制
        根据数值创建年代时代对象。

        时代在概念上是时间线上最大的一个部门。 大多数日历系统具有将时间线划分为两个时代的单个时期。 然而,有些有多个时代,比如每个领导人统治的时代。 确切的含义由年龄根据以下约束决定。

        1970-01-01使用的时代必须具有值1.后来的时代必须具有较高的值。 较早的时间必须具有较低的值。 每个年表必须参考枚举或类似的单身,以提供时代价值观。

        该方法返回指定时代值的正确类型的单例时代。

        Specified by:
        eraOf在接口 Chronology
        参数
        eraValue - 时代价值
        结果
        日历系统时代,不为空
      • eras

        public List<Era> eras​()
        说明从接口Chronology复制
        获取年表的时间列表。

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

        Specified by:
        eras在接口 Chronology
        结果
        时间表的时代列表可能是不可变的,不为零
      • range

        public ValueRange range​(ChronoField field)
        说明从接口Chronology复制
        获取指定字段的有效值的范围。

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

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

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

        Specified by:
        range在接口 Chronology
        参数
        field - 获取范围的字段,不为null
        结果
        字段的有效值的范围不为null
      • resolveDate

        public MinguoDate resolveDate​(Map<TemporalField,Long> fieldValues,
                                      ResolverStyle resolverStyle)
        说明从类别复制: AbstractChronology
        解析时解析为ChronoField值。

        大多数TemporalField实现使用该字段上的resolve方法进行解析。 相比之下, ChronoField类定义的字段只具有相对于年表的意义。 因此,在具体年表的上下文中解决了ChronoField日期字段。

        ChronoField实例通过此方法解决,可能会在子类中被覆盖。

        • EPOCH_DAY - 如果存在,将转换为日期,然后根据日期对所有其他日期字段进行交叉检查。
        • PROLEPTIC_MONTH - 如果存在,则分为YEARMONTH_OF_YEAR 如果模式是严格的或智能的,则该字段被验证。
        • YEAR_OF_ERAERA - 如果两者都存在,则它们被组合以形成YEAR 在宽松模式下, YEAR_OF_ERA范围不能在智能和严格模式下进行验证。 在所有三种模式下, ERA的范围都被验证。 如果只有YEAR_OF_ERA存在,并且模式是聪明或宽松的,那么假设最后一个可用的时代。 在严格的模式下,没有假设时代, YEAR_OF_ERA保持不变。 如果只有ERA存在,那么它将保持不变。
        • YEARMONTH_OF_YEARDAY_OF_MONTH -如果所有三个都存在,那么它们被组合成一个日期。 在所有三种模式下, YEAR都经过验证。 如果模式是聪明或严格的,则验证月和日。 如果模式宽松,则以相当于在请求年份的第一个月的第一天创建日期的方式组合日期,然后将月份中的差额加上差异天数。 如果模式是聪明的,并且月的日期大于年月的最大值,则月的日期被调整到最后一个月。 如果模式严格,则三个字段必须形成有效的日期。
        • YEARDAY_OF_YEAR - 如果两者都存在,则将它们组合以形成日期。 在所有三种模式下, YEAR都经过验证。 如果模式宽松,那么日期将以相当于在请求年的第一天创建日期的方式组合,然后加上差异。 如果模式是聪明或严格的,那么这两个字段必须形成一个有效的日期。
        • YEARMONTH_OF_YEARALIGNED_WEEK_OF_MONTHALIGNED_DAY_OF_WEEK_IN_MONTH -如果所有四个都存在,则它们被组合以形成一个日期。 在所有三种模式下, YEAR都经过验证。 如果该模式宽松,那么日期将以相当于在所请求的年份的第一个月的第一天创建日期的方式组合,然后加上月差,然后以周为单位,然后以天为单位。 如果模式是聪明或严格的,那么所有四个字段都将被验证到其外部范围。 然后将该日期以相当于在所请求的年和月的第一天创建日期的方式组合,然后以数周和数天的数量添加以达到其值。 如果模式严格,则还会验证日期,以检查日和周的调整次数是否不变。
        • YEARMONTH_OF_YEARALIGNED_WEEK_OF_MONTHDAY_OF_WEEK -如果所有四个都存在,则它们被组合以形成一个日期。 该方法与上述相同,多年,数月ALIGNED_DAY_OF_WEEK_IN_MONTH周在ALIGNED_DAY_OF_WEEK_IN_MONTH 一天一个月,几周和几周已被处理,星期几被调整为下一个或相同的匹配日。
        • YEARALIGNED_WEEK_OF_YEARALIGNED_DAY_OF_WEEK_IN_YEAR -如果所有三个都存在,那么它们被组合成一个日期。 在所有三种模式下,验证YEAR 如果模式宽松,那么日期以相当于在所请求年的第一天创建日期的方式组合,然后以周为单位加上差异。 如果模式是聪明或严格的,那么所有三个字段都将被验证到其外部范围。 然后,该日期以相当于在所请求年的第一天创建日期的方式组合,然后以数周和数天添加以达到其值。 如果模式严格,日期也会被验证,以检查日和周的调整没有改变年份。
        • YEARALIGNED_WEEK_OF_YEARDAY_OF_WEEK -如果所有三个都存在,那么它们被组合成一个日期。 该方法与ALIGNED_DAY_OF_WEEK_IN_YEAR中的上述几年和几周ALIGNED_DAY_OF_WEEK_IN_YEAR 一天一周的时间一周调整为下一个或相同的匹配日期,一年的时间和周数被处理。

        默认实现适用于大多数日历系统。 如果ChronoField.YEAR_OF_ERA是没有发现ChronoField.ERA然后在最后的时代Chronology.eras()使用。 实施假定为7天,第一个月的日期为1,第一天的值为1,并且月份和年份的第一个始终存在。

        Specified by:
        resolveDate在接口 Chronology
        重写:
        resolveDateAbstractChronology
        参数
        fieldValues - 可以更新的值的字段映射,不为null
        resolverStyle - 请求的解析类型,不为null
        结果
        the resolved date, null if insufficient information to create a date