Класс 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(). Реализация предполагает семидневную неделю, что первое число месяца имеет значение 1, что первое число года имеет значение 1, и что первое число месяца и года всегда существует.