Класс 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 из числового значения. Система календаря Хиджры имеет только одну эру, охватывающую пролептические годы, большие нуля. Этот метод возвращает единственный 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, и что первое число месяца и года всегда существует.