Класс IsoChronology

public static final IsoChronology INSTANCE

Единственный экземпляр хроники ISO.

public String getId()

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

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

public String getCalendarType()

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

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

Эквивалентно вызову 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. Последующие эры должны иметь последовательно возрастающие значения. Предшествующие эры должны иметь последовательно убывающие значения. Каждая хроника должна использовать enum или аналогичный singleton для представления значений эр.

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

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.