Класс MinguoChronology

Идентификатор однозначно определяет 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. Более поздние эры должны иметь последовательно возрастающие значения. Более ранние эры должны иметь последовательно убывающие значения. Каждая календарная система должна использовать enum или аналогичный объект-синглтон для представления значений эр.

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

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

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

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

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

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