Класс HijrahChronology

public static final HijrahChronology INSTANCE

Экземпляр-синглтон исламского календаря Умм аль-Кура Саудовской Аравии. Другие варианты хиджрской хронологии могут быть доступны через Chronology.getAvailableChronologies().

public String getId()

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

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

public String getCalendarType()

Возвращает тип исламского календаря.

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

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

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

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

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

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

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

public HijrahDate dateYearDay(int prolepticYear, int dayOfYear)

Создает локальную дату в системе хиджрского календаря по полям пролептического года и дня года.

public HijrahDate dateEpochDay(long epochDay)

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

public HijrahDate dateNow()

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

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

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

public HijrahDate dateNow(ZoneId zone)

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

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

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

public HijrahDate dateNow(Clock clock)

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

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

public HijrahDate date(TemporalAccessor temporal)

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

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

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

Сигнатура этого метода соответствует сигнатуре функционального интерфейса TemporalQuery, что позволяет использовать его как запрос посредством ссылки на метод, aChronology::date.

public ChronoLocalDateTime<HijrahDate> localDateTime(TemporalAccessor temporal)

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

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

Преобразование извлекает из временного объекта ChronoLocalDate и LocalTime и объединяет их. Реализациям разрешено выполнять оптимизацию, например обращаться к полям, эквивалентным соответствующим объектам. Результат использует эту хронологию.

Сигнатура этого метода соответствует сигнатуре функционального интерфейса TemporalQuery, что позволяет использовать его как запрос посредством ссылки на метод, aChronology::localDateTime.

public ChronoZonedDateTime<HijrahDate> zonedDateTime(TemporalAccessor temporal)

Получает ChronoZonedDateTime в этой хронологии из другого временного объекта.

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

Сначала преобразование получает из временного объекта ZoneId, а при необходимости использует ZoneOffset. Затем оно пытается получить Instant, а при необходимости использует ChronoLocalDateTime. Результатом будет объединение ZoneId или ZoneOffset с Instant или ChronoLocalDateTime. Реализациям разрешено выполнять оптимизацию, например обращаться к полям, эквивалентным соответствующим объектам. Результат использует эту хронологию.

Сигнатура этого метода соответствует сигнатуре функционального интерфейса TemporalQuery, что позволяет использовать его как запрос посредством ссылки на метод, aChronology::zonedDateTime.

public ChronoZonedDateTime<HijrahDate> zonedDateTime(Instant instant, ZoneId zone)

Получает ChronoZonedDateTime в этой хронологии из Instant.

Этот метод получает дату и время с часовым поясом, соответствующие указанному моменту времени.

public boolean isLeapYear(long prolepticYear)

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

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

• Високосный год должен быть длиннее невисокосного.
• Хронология, не поддерживающая понятие года, должна возвращать false.
• Для всех лет в допустимом диапазоне лет хронологии должен возвращаться правильный результат.

За пределами допустимого диапазона лет реализация может вернуть наиболее вероятный результат или false. Реализация не должна выбрасывать исключение, даже если год находится за пределами допустимого диапазона.

public int prolepticYear(Era era, int yearOfEra)

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

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

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

public HijrahEra eraOf(int eraValue)

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

public List<Era> eras()

Возвращает список эр хронологии.

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

public ValueRange range(ChronoField field)

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

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

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

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

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

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

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

Экземпляры ChronoField разрешаются этим методом, который может быть переопределен в подклассах.

• EPOCH_DAY — если присутствует, преобразуется в дату, после чего все остальные поля даты проверяются на согласованность с ней.
• 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 — если присутствуют все три поля, они объединяются в дату. Во всех трех режимах проверяется YEAR. В интеллектуальном и строгом режимах проверяются месяц и день. В нестрогом режиме дата формируется так, как если бы была создана дата на первый день первого месяца указанного года, а затем добавлена разница в месяцах и разница в днях. В интеллектуальном режиме, если день месяца больше максимального значения для указанного года и месяца, он корректируется до последнего дня месяца. В строгом режиме три поля должны образовывать допустимую дату.
• YEAR и DAY_OF_YEAR — если присутствуют оба поля, они объединяются в дату. Во всех трех режимах проверяется YEAR. В нестрогом режиме дата формируется так, как если бы была создана дата на первый день указанного года, а затем добавлена разница в днях. В интеллектуальном и строгом режимах эти два поля должны образовывать допустимую дату.
• YEAR, MONTH_OF_YEAR, ALIGNED_WEEK_OF_MONTH и ALIGNED_DAY_OF_WEEK_IN_MONTH — если присутствуют все четыре поля, они объединяются в дату. Во всех трех режимах проверяется YEAR. В нестрогом режиме дата формируется так, как если бы была создана дата на первый день первого месяца указанного года, а затем добавлены разница в месяцах, разница в неделях и разница в днях. В интеллектуальном и строгом режимах все четыре поля проверяются на соответствие их внешним диапазонам. Затем дата формируется так, как если бы была создана дата на первый день указанного года и месяца, а затем добавлено количество недель и дней, необходимое для получения заданных значений. В строгом режиме дополнительно проверяется, что корректировка дня и недели не изменила месяц.
• YEAR, MONTH_OF_YEAR, ALIGNED_WEEK_OF_MONTH и DAY_OF_WEEK — если присутствуют все четыре поля, они объединяются в дату. Используется тот же подход, что и описанный выше для лет, месяцев и недель в ALIGNED_DAY_OF_WEEK_IN_MONTH. После обработки лет, месяцев и недель день недели корректируется до следующего или текущего соответствующего дня недели.
• YEAR, ALIGNED_WEEK_OF_YEAR и ALIGNED_DAY_OF_WEEK_IN_YEAR — если присутствуют все три поля, они объединяются в дату. Во всех трех режимах проверяется YEAR. В нестрогом режиме дата формируется так, как если бы была создана дата на первый день указанного года, а затем добавлены разница в неделях и разница в днях. В интеллектуальном и строгом режимах все три поля проверяются на соответствие их внешним диапазонам. Затем дата формируется так, как если бы была создана дата на первый день указанного года, а затем добавлено количество недель и дней, необходимое для получения заданных значений. В строгом режиме дополнительно проверяется, что корректировка дня и недели не изменила год.
• YEAR, ALIGNED_WEEK_OF_YEAR и DAY_OF_WEEK — если присутствуют все три поля, они объединяются в дату. Используется тот же подход, что и описанный выше для лет и недель в ALIGNED_DAY_OF_WEEK_IN_YEAR. После обработки лет и недель день недели корректируется до следующего или текущего соответствующего дня недели.

Реализация по умолчанию подходит для большинства календарных систем. Если обнаружено ChronoField.YEAR_OF_ERA без ChronoField.ERA, используется последняя эра из Chronology.eras(). Реализация предполагает, что неделя состоит из 7 дней, первый день месяца имеет значение 1, первый день года имеет значение 1, а первый день месяца и года существует всегда.