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