Класс ThaiBuddhistChronology

Идентификатор однозначно определяет Chronology. Его можно использовать для поиска Chronology с помощью Chronology.of(String).

Тип календаря — это идентификатор, определённый спецификацией языка разметки данных локалей Unicode (LDML). Его можно использовать для поиска Chronology с помощью Chronology.of(String). Он также может использоваться как часть локали и доступен через Locale.getUnicodeLocaleType(String) с ключом 'ca'.

Для получения текущей даты выполняется запрос к system clock в часовом поясе по умолчанию.

Использование этого метода не позволяет применять альтернативные часы для тестирования, поскольку часы заданы жёстко.

Для получения текущей даты выполняется запрос к system clock. Указание часового пояса исключает зависимость от часового пояса по умолчанию.

Использование этого метода не позволяет применять альтернативные часы для тестирования, поскольку часы заданы жёстко.

Для получения текущей даты — сегодняшнего дня — выполняется запрос к указанным часам. Этот метод позволяет использовать альтернативные часы для тестирования. Альтернативные часы можно создать с помощью dependency injection.

Этот метод получает дату в данной хронологии на основе указанного временного объекта. TemporalAccessor представляет произвольный набор сведений о дате и времени, который эта фабрика преобразует в экземпляр ChronoLocalDate.

При преобразовании обычно используется поле EPOCH_DAY, стандартизированное для календарных систем.

Сигнатура этого метода соответствует функциональному интерфейсу TemporalQuery, что позволяет использовать его как запрос посредством ссылки на метод, aChronology::date.

Этот метод получает дату и время в данной хронологии на основе указанного временного объекта. TemporalAccessor представляет произвольный набор сведений о дате и времени, который эта фабрика преобразует в экземпляр ChronoLocalDateTime.

При преобразовании из временного объекта извлекаются и объединяются ChronoLocalDate и LocalTime. Реализациям разрешается выполнять оптимизации, например обращаться к полям, эквивалентным соответствующим объектам. Результат использует эту хронологию.

Сигнатура этого метода соответствует функциональному интерфейсу TemporalQuery, что позволяет использовать его как запрос посредством ссылки на метод, aChronology::localDateTime.

Этот метод получает дату и время с часовым поясом в данной хронологии на основе указанного временного объекта. TemporalAccessor представляет произвольный набор сведений о дате и времени, который эта фабрика преобразует в экземпляр ChronoZonedDateTime.

Сначала преобразование попытается получить ZoneId из временного объекта, а при необходимости — ZoneOffset. Затем оно попытается получить Instant, а при необходимости — ChronoLocalDateTime. В результате будет получено сочетание ZoneId или ZoneOffset с Instant или ChronoLocalDateTime. Реализациям разрешается выполнять оптимизации, например обращаться к полям, эквивалентным соответствующим объектам. Результат использует эту хронологию.

Сигнатура этого метода соответствует функциональному интерфейсу TemporalQuery, что позволяет использовать его как запрос посредством ссылки на метод, aChronology::zonedDateTime.

Этот метод получает дату и время с часовым поясом, соответствующие указанному моменту времени.

Високосные годы тайского буддийского календаря полностью совпадают с високосными годами ISO. Этот метод не проверяет переданный год и даёт определённый результат только для годов в поддерживаемом диапазоне.

Этот метод объединяет эру и год эры в единое поле пролептического года.

Если хронология активно использует эры, например JapaneseChronology, год эры проверяется на соответствие эре. Для других хронологий проверка необязательна.

Эра — это, по сути, крупнейшее деление временной шкалы. В большинстве календарных систем существует одна эпоха, разделяющая временную шкалу на две эры. Однако в некоторых системах несколько эр, например по одной на период правления каждого лидера. Точное значение определяется хронологией с учётом следующих ограничений.

Эра, действующая на дату 1970-01-01, должна иметь значение 1. Более поздние эры должны иметь последовательно возрастающие значения. Более ранние эры должны иметь последовательно убывающие значения. Каждая хронология должна использовать перечисление или аналогичный объект-одиночку для представления значений эр.

Этот метод возвращает объект-одиночку эры правильного типа для указанного значения эры.

В большинстве календарных систем есть эра, в пределах которой имеет смысл год. Если календарная система не поддерживает понятие эр, необходимо вернуть пустой список.

Все поля можно представить в виде целого числа типа long. Этот метод возвращает объект, описывающий допустимый диапазон такого значения.

Обратите внимание, что результат описывает только минимальное и максимальное допустимые значения; не следует делать на их основании слишком далеко идущих выводов. Например, в диапазоне могут быть значения, недопустимые для данного поля.

Метод возвращает результат независимо от того, поддерживает ли хронология это поле.

Большинство реализаций 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, а первый день месяца и года всегда существует.