Класс MinguoChronology

public static final MinguoChronology INSTANCE

Экземпляр-синглтон для летоисчисления Минго.

public String getId()

Возвращает идентификатор летоисчисления — 'Minguo'.

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

public String getCalendarType()

Возвращает тип календаря базовой календарной системы — 'roc'.

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

public MinguoDate date(Era era, int yearOfEra, int month, int dayOfMonth)

Создает локальную дату в календарной системе Минго из полей эры, года эры, месяца года и дня месяца.

public MinguoDate date(int prolepticYear, int month, int dayOfMonth)

Создает локальную дату в календарной системе Минго из полей пролептического года, месяца года и дня месяца.

public MinguoDate dateYearDay(Era era, int yearOfEra, int dayOfYear)

Создает локальную дату в календарной системе Минго из полей эры, года эры и дня года.

public MinguoDate dateYearDay(int prolepticYear, int dayOfYear)

Создает локальную дату в календарной системе Минго из полей пролептического года и дня года.

public MinguoDate dateEpochDay(long epochDay)

Создает локальную дату в календарной системе Минго из дня эпохи.

public MinguoDate dateNow()

Получает текущую локальную дату в этом летоисчислении по системным часам в часовом поясе по умолчанию.

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

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

public MinguoDate dateNow(ZoneId zone)

Получает текущую локальную дату в этом летоисчислении по системным часам в указанном часовом поясе.

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

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

public MinguoDate dateNow(Clock clock)

Получает текущую локальную дату в этом летоисчислении по указанным часам.

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

public MinguoDate date(TemporalAccessor temporal)

Получает локальную дату в этом летоисчислении из другого объекта temporal.

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

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

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

public ChronoLocalDateTime<MinguoDate> localDateTime(TemporalAccessor temporal)

Получает локальные дату и время в этом летоисчислении из другого объекта temporal.

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

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

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

public ChronoZonedDateTime<MinguoDate> zonedDateTime(TemporalAccessor temporal)

Получает ChronoZonedDateTime в этом летоисчислении из другого объекта temporal.

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

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

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

public ChronoZonedDateTime<MinguoDate> zonedDateTime(Instant instant, ZoneId zone)

Получает ChronoZonedDateTime в этом летоисчислении из Instant.

Метод получает дату и время с часовым поясом с тем же моментом времени, что и указанный.

public boolean isLeapYear(long prolepticYear)

Проверяет, является ли указанный год високосным.

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

public int prolepticYear(Era era, int yearOfEra)

Вычисляет пролептический год по эре и году эры.

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

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

public MinguoEra eraOf(int eraValue)

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

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

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

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

public List<Era> eras()

Возвращает список эр этого летоисчисления.

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

public ValueRange range(ChronoField field)

Возвращает диапазон допустимых значений указанного поля.

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

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

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

public MinguoDate resolveDate(Map<TemporalField, Long> fieldValues, ResolverStyle resolverStyle)

Преобразует разобранные значения ChronoField в дату во время разбора.

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

public boolean isIsoBased()

MinguoChronology — летоисчисление на основе ISO, поддерживающее поля из IsoFields, например DAY_OF_QUARTER и QUARTER_OF_YEAR.