Класс MinguoChronology

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

Тип календаря — это идентификатор, определённый спецификацией Unicode Locale Data Markup Language (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 реализаций разрешаются с помощью метода 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, и что первый день месяца и года всегда существуют.