Класс IsoChronology

public static final IsoChronology INSTANCE

Экземпляр-синглтон хронологии ISO.

public String getId()

Возвращает идентификатор хронологии — 'ISO'.

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

public String getCalendarType()

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

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

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

Получает локальную дату ISO по эпохе, году эпохи, месяцу и дню месяца.

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

Получает локальную дату ISO по пролептическому году, месяцу и дню месяца.

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

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

Получает локальную дату ISO по эпохе, году эпохи и дню года.

public LocalDate dateYearDay(int prolepticYear, int dayOfYear)

Получает локальную дату ISO по пролептическому году и дню года.

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

public LocalDate dateEpochDay(long epochDay)

Получает локальную дату ISO по эпохе.

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

public LocalDate date(TemporalAccessor temporal)

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

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

public long epochSecond(int prolepticYear, int month, int dayOfMonth, int hour, int minute, int second, ZoneOffset zoneOffset)

Получает количество секунд от эпохи 1970-01-01T00:00:00Z.

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

public LocalDateTime localDateTime(TemporalAccessor temporal)

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

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

public ZonedDateTime zonedDateTime(TemporalAccessor temporal)

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

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

public ZonedDateTime zonedDateTime(Instant instant, ZoneId zone)

Получает часовое время ISO в данной хронологии из момента времени.

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

public LocalDate dateNow()

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

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

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

public LocalDate dateNow(ZoneId zone)

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

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

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

public LocalDate dateNow(Clock clock)

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

Это запросит указанные часы, чтобы получить текущую дату - сегодня. Использование этого метода позволяет использовать альтернативные часы для тестирования. Альтернативные часы могут быть введены с помощью dependency injection.

public boolean isLeapYear(long prolepticYear)

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

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

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

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

public int prolepticYear(Era era, int yearOfEra)

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

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

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

public IsoEra eraOf(int eraValue)

Создает объект эры хронологии из числового значения.

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

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

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

public List<Era> eras()

Получает список эр для хронологии.

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

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

Разрешает проанализированные ChronoField значения в дату во время разбора.

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

public ValueRange range(ChronoField field)

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

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

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

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

public Period period(int years, int months, int days)

Получает период для этой хронологии на основе лет, месяцев и дней.

Это возвращает период, связанный с хронологией ISO, используя указанные годы, месяцы и дни. Подробнее см. Period.

public boolean isIsoBased()

IsoChronology является хронологией ISO, которая поддерживает поля в IsoFields, такие как DAY_OF_QUARTER и QUARTER_OF_YEAR.