Module java.base
Package java.time.chrono

Class ThaiBuddhistChronology

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

此年表定义了泰国佛教日历系统的规则。该日历系统主要在泰国使用。日期对齐，使得2484-01-01（佛历）等于1941-01-01（ISO）。

字段定义如下:

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

  • Field Details

  • Method Details

    • getId

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

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

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

    • getCalendarType

      public String getCalendarType()
      获取底层日历系统的日历类型 - 'buddhist'。

      日历类型是由Unicode Locale Data Markup Language (LDML)规范定义的标识符。可以使用它来查找Chronology，方法是使用Chronology.of(String)。也可以作为区域设置的一部分使用，通过使用带有键'ca'的Locale.getUnicodeLocaleType(String)来访问。

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

    • date

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

    • date

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

    • dateYearDay

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

    • dateYearDay

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

    • dateEpochDay

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

    • dateNow

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

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

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

      指定者：
      dateNow 在接口 Chronology中
      返回：
      使用系统时钟和默认时区获取当前本地日期，不为null

    • dateNow

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

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

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

      指定者：
      dateNow 在接口 Chronology中
      参数：
      zone - 要使用的时区ID，不为null
      返回：
      使用系统时钟获取当前本地日期，不为null

    • dateNow

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

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

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

    • date

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

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

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

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

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

    • localDateTime

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

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

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

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

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

    • zonedDateTime

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

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

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

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

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

    • zonedDateTime

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

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

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

    • isLeapYear

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

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

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

    • prolepticYear

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

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

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

      指定者：
      prolepticYear 在接口 Chronology中
      参数：
      era - 适合年表的纪元，不为null
      yearOfEra - 年表纪元年
      返回：
      纪年

    • eraOf

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

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

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

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

      指定由：
      eraOf 在接口 Chronology
      参数：
      eraValue - 时代值
      返回：
      日历系统的时代，非空

    • eras

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

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

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

    • range

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

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

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

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

      指定由：
      range 在接口 Chronology
      参数：
      field - 要获取范围的字段，非空
      返回：
      该字段的有效值范围，非空

    • resolveDate

      public ThaiBuddhistDate 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()
      ThaiBuddhistChronology是基于ISO的年表，支持IsoFields中的字段，例如DAY_OF_QUARTER和QUARTER_OF_YEAR。
      指定由：
      isIsoBased 在接口 Chronology
      返回：
      true
      自：
      19
      参见：