Класс 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 по мгновению времени.

Эквивалентно 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)

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

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

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