Класс 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 разрешаются с помощью метода 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, а первый день месяца и года всегда существует.