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

Class ThaiBuddhistChronology

  • All Implemented Interfaces:
    Serializable ， Comparable<Chronology> ， Chronology 

    public final class ThaiBuddhistChronology
extends AbstractChronology
implements Serializable
    泰国佛教日历系统。

    这个年表定义了泰国佛教日历系统的规则。 这个日历系统主要用于泰国。 日期对齐，使得2484-01-01 (Buddhist)为1941-01-01 (ISO) 。

    字段定义如下：

    • 时代 - 有两个时代，当前的“佛教”（ERA_BE）和前一个时代（ERA_BEFORE_BE）。
    • 年代 - 当代时代的年代从一年的时代起统一起来。 对于前一个时代，一年中随着时间的推移而增加。 当前时代的价值等于ISO光学年加543。
    • 幼稚年份 - 幼稚年份与当今时代相同。 对于以前的时代，岁月有零，然后负值。 该值等于ISO proleptic-year加上543。
    • 一年的时间 - 泰国Buddhist的年份与ISO完全一致。
    • 每月的日子 - ThaiBuddhist的日期与ISO完全一致。
    • 日期 - 泰国Buddhist日期与ISO完全一致。
    • 闰年 - 泰国的闰年模式与ISO完全匹配，使得两个日历永远不会失步。
    实现要求：
    这个类是不可变的和线程安全的。
    从以下版本开始：
    1.8
    另请参见：
    Serialized Form

    • 方法详细信息

      • getCalendarType

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

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

        Specified by:
        getCalendarType在接口 Chronology
        结果
        日历系统类型 - “佛教”
        另请参见：
        getId()

      • date

        public ThaiBuddhistDate date​(Era era,
                             int yearOfEra,
                             int month,
                             int dayOfMonth)
        从时代，年龄，月份和月份的时代，获得泰国佛教日历系统的当地日期。
        Specified by:
        date在接口 Chronology
        参数
        era - 泰国佛教时代，不为空
        yearOfEra - 年代
        month - 年月
        dayOfMonth - 月份
        结果
        泰国佛教当地日期，不为空
        异常
        DateTimeException - 如果无法创建日期
        ClassCastException - 如果 era不是一个 ThaiBuddhistEra

      • date

        public ThaiBuddhistDate date​(int prolepticYear,
                             int month,
                             int dayOfMonth)
        在泰国佛教日历系统中，从幼稚年份，月份和月份月份获取当地日期。
        Specified by:
        date在接口 Chronology
        参数
        prolepticYear - prolepticYear年
        month - 年月
        dayOfMonth - 月的日子
        结果
        泰国佛教当地日期，不为空
        异常
        DateTimeException - 如果无法创建日期

      • dateYearDay

        public ThaiBuddhistDate dateYearDay​(Era era,
                                    int yearOfEra,
                                    int dayOfYear)
        在泰国佛教日历系统中，从时代，年龄和日期领域获得当地日期。
        Specified by:
        dateYearDay在接口 Chronology
        参数
        era - 泰国佛教时代，不为空
        yearOfEra - 年代
        dayOfYear - 一年的一天
        结果
        泰国佛教当地日期，不为空
        异常
        DateTimeException - 如果无法创建日期
        ClassCastException - 如果 era不是一个 ThaiBuddhistEra

      • dateYearDay

        public ThaiBuddhistDate dateYearDay​(int prolepticYear,
                                    int dayOfYear)
        在泰国佛教日历系统中，从幼稚年份和日期领域获得当地日期。
        Specified by:
        dateYearDay在接口 Chronology
        参数
        prolepticYear - prolepticYear年
        dayOfYear - 一年的一天
        结果
        泰国佛教当地日期，不为空
        异常
        DateTimeException - 如果无法创建日期

      • dateEpochDay

        public ThaiBuddhistDate dateEpochDay​(long epochDay)
        从泰国佛教日历系统中获取当地的日期。
        Specified by:
        dateEpochDay在接口 Chronology
        参数
        epochDay - 纪元日
        结果
        泰国佛教当地日期，不为空
        异常
        DateTimeException - 如果无法创建日期

      • dateNow

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

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

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

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

      • dateNow

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

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

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

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

      • dateNow

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

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

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

      • date

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

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

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

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

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

      • localDateTime

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

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

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

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

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

      • zonedDateTime

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

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

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

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

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

      • zonedDateTime

        public ChronoZonedDateTime<ThaiBuddhistDate> zonedDateTime​(Instant instant,
                                                           ZoneId zone)
        说明从界面Chronology复制
        获得ChronoZonedDateTime在从这个年表Instant 。

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

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

      • isLeapYear

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

        泰国佛教闰年恰好符合ISO闰年。 该方法不能验证所传递的年份，并且在支持的范围内只有明确的结果多年。

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

      • prolepticYear

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

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

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

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

      • eraOf

        public ThaiBuddhistEra 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

      • resolveDate

        public ThaiBuddhistDate resolveDate​(Map<TemporalField,Long> fieldValues,
                                    ResolverStyle resolverStyle)
        描述从类别复制： AbstractChronology
        解析解析中的ChronoField值。

        大多数TemporalField实现使用该字段上的resolve方法进行解析。 相比之下， 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数年，数月ALIGNED_DAY_OF_WEEK_IN_MONTH周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数年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
        重写：
        resolveDate在 AbstractChronology
        参数
        fieldValues - 可以更新的值的字段映射，不为null
        resolverStyle - 请求的解析类型，不为空
        结果
        the resolved date, null if insufficient information to create a date