Класс IsoChronology

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

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

Эквивалентно LocalDate.of(int, int, int).

Эквивалентно LocalDate.ofYearDay(int, int).

Эквивалентно LocalDate.ofEpochDay(long).

Эквивалентно LocalDate.from(TemporalAccessor).

Количество секунд вычисляется с использованием года, месяца, дня месяца, часа, минуты, секунды и смещения часового пояса.

Эквивалентно LocalDateTime.from(TemporalAccessor).

Эквивалентно ZonedDateTime.from(TemporalAccessor).

Эквивалентно ZonedDateTime.ofInstant(Instant, ZoneId).

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

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

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

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

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

Этот метод применяет действующие правила определения високосных годов ко всей временной шкале. В общем случае год является високосным, если делится на четыре без остатка. Однако годы, делящиеся на 100, не являются високосными, за исключением годов, делящихся на 400.

Например, 1904 год является високосным, так как делится на 4. 1900 год не был високосным, так как делится на 100, однако 2000 год был високосным, так как делится на 400.

Вычисление является пролептическим — те же правила применяются к далекому будущему и далекому прошлому. Исторически это неточно, но соответствует стандарту ISO-8601.

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

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

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

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

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

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

Большинство реализаций TemporalField разрешаются с помощью метода resolve поля. В отличие от них, класс ChronoField определяет поля, смысл которых зависит от хронологии. Поэтому поля даты ChronoField разрешаются здесь в контексте конкретной хронологии.

Экземпляры ChronoField в календарной системе ISO разрешаются следующим образом.

• EPOCH_DAY — если поле присутствует, оно преобразуется в LocalDate, после чего все остальные поля даты сверяются с датой.
• PROLEPTIC_MONTH — если поле присутствует, оно разделяется на YEAR и MONTH_OF_YEAR. При строгом и интеллектуальном режимах выполняется проверка поля.
• YEAR_OF_ERA и ERA — если присутствуют оба поля, они объединяются в YEAR. В нестрогом режиме диапазон YEAR_OF_ERA не проверяется, а в интеллектуальном и строгом режимах проверяется. Диапазон ERA проверяется во всех трех режимах. Если присутствует только YEAR_OF_ERA, а режим интеллектуальный или нестрогий, предполагается текущая эра (CE/AD). В строгом режиме эра не предполагается, а YEAR_OF_ERA остается без изменений. Если присутствует только ERA, оно остается без изменений.
• YEAR, MONTH_OF_YEAR и DAY_OF_MONTH — если присутствуют все три поля, они объединяются в LocalDate. Во всех трех режимах проверяется YEAR. В интеллектуальном и строгом режимах проверяются месяц и день; день проверяется в диапазоне от 1 до 31. В нестрогом режиме дата объединяется так, как если бы сначала была создана дата первого января указанного года, затем к ней добавлена разница в месяцах, а потом разница в днях. В интеллектуальном режиме, если день месяца превышает максимальное значение для указанного года и месяца, он корректируется до последнего дня месяца. В строгом режиме три поля должны составлять допустимую дату.
• YEAR и DAY_OF_YEAR — если присутствуют оба поля, они объединяются в LocalDate. Во всех трех режимах проверяется YEAR. В нестрогом режиме дата объединяется так, как если бы сначала была создана дата первого января указанного года, а затем добавлена разница в днях. В интеллектуальном и строгом режимах два поля должны составлять допустимую дату.
• YEAR, MONTH_OF_YEAR, ALIGNED_WEEK_OF_MONTH и ALIGNED_DAY_OF_WEEK_IN_MONTH — если присутствуют все четыре поля, они объединяются в LocalDate. Во всех трех режимах проверяется YEAR. В нестрогом режиме дата объединяется так, как если бы сначала была создана дата первого января указанного года, затем добавлена разница в месяцах, далее разница в неделях, а затем в днях. В интеллектуальном и строгом режимах все четыре поля проверяются на соответствие граничным значениям. Затем дата объединяется так, как если бы сначала была создана дата первого дня указанного года и месяца, а затем добавлено заданное количество недель и дней для достижения соответствующих значений. В строгом режиме дополнительно проверяется, что корректировка дня и недели не изменила месяц.
• YEAR, MONTH_OF_YEAR, ALIGNED_WEEK_OF_MONTH и DAY_OF_WEEK — если присутствуют все четыре поля, они объединяются в LocalDate. Используется тот же подход, что и описанный выше для годов, месяцев и недель в ALIGNED_DAY_OF_WEEK_IN_MONTH. После обработки годов, месяцев и недель день недели корректируется до следующего совпадающего дня недели или остается без изменений, если он уже совпадает.
• YEAR, ALIGNED_WEEK_OF_YEAR и ALIGNED_DAY_OF_WEEK_IN_YEAR — если присутствуют все три поля, они объединяются в LocalDate. Во всех трех режимах проверяется YEAR. В нестрогом режиме дата объединяется так, как если бы сначала была создана дата первого января указанного года, а затем добавлена разница в неделях и днях. В интеллектуальном и строгом режимах все три поля проверяются на соответствие граничным значениям. Затем дата объединяется так, как если бы сначала была создана дата первого дня указанного года, а затем добавлено заданное количество недель и дней для достижения соответствующих значений. В строгом режиме дополнительно проверяется, что корректировка дня и недели не изменила год.
• YEAR, ALIGNED_WEEK_OF_YEAR и DAY_OF_WEEK — если присутствуют все три поля, они объединяются в LocalDate. Используется тот же подход, что и описанный выше для годов и недель в ALIGNED_DAY_OF_WEEK_IN_YEAR. После обработки годов и недель день недели корректируется до следующего совпадающего дня недели или остается без изменений, если он уже совпадает.

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

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

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

Возвращает период, связанный с хронологией ISO и заданными годами, месяцами и днями. Дополнительные сведения см. в описании Period.