Класс HijrahChronology

public static final HijrahChronology INSTANCE

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

public String getId()

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

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

public String getCalendarType()

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

Тип календаря — это идентификатор, определенный спецификацией Unicode Locale Data Markup Language (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 из числового значения. Система календаря Хиджры имеет только одну эру, охватывающую пролептические годы больше нуля. Этот метод возвращает единственную эру Хиджры для значения 1.

public List<Era> eras()

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

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

public ValueRange range(ChronoField field)

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

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

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

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

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

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

Большинство TemporalField реализаций разрешаются с помощью метода resolve для поля. В отличие от этого, класс 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, и что первое число месяца и года всегда существует.