Класс HijrahDate

public static HijrahDate now()

Получает текущую дату HijrahDate исламского календаря Umm Al-Qura в часовом поясе по умолчанию.

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

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

public static HijrahDate now(ZoneId zone)

Получает текущую дату HijrahDate исламского календаря Umm Al-Qura в указанном часовом поясе.

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

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

public static HijrahDate now(Clock clock)

Получает текущую дату HijrahDate исламского календаря Umm Al-Qura из указанных часов.

Этот метод обращается к указанным часам для получения текущей даты — сегодняшней. Использование этого метода позволяет использовать альтернарный часовой механизм для тестирования. Альтернативный часовой механизм может быть добавлен с помощью введения зависимостей.

public static HijrahDate of(int prolepticYear, int month, int dayOfMonth)

Получает дату HijrahDate исламского календаря Umm Al-Qura по пролептическому году, месяцу и дню.

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

public static HijrahDate from(TemporalAccessor temporal)

Получает дату HijrahDate исламского календаря Umm Al-Qura из временного объекта.

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

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

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

public HijrahChronology getChronology()

Возвращает хронологию этой даты, которая является системой календаря хиджры.

Хронология представляет систему календаря, используемого в текущий момент. Эра и другие поля в ChronoField определяются хронологией.

public HijrahEra getEra()

Возвращает эру, применимую к этой дате.

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

public int lengthOfMonth()

Возвращает длительность месяца, представленного этой датой.

Возвращает длительность месяца в днях. Длительность месяцев в системе календаря хиджры варьируется от 29 до 30 дней.

public int lengthOfYear()

Возвращает длительность года, представленного этой датой.

Возвращает длительность года в днях. Год в системе календаря хиджры обычно короче, чем в системе календаря ISO.

public long getLong(TemporalField field)

Возвращает значение указанного поля как long.

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

public HijrahDate with(TemporalField field, long newValue)

Возвращает объект того же типа, что и этот объект, с изменённым указанным полем.

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

В некоторых случаях изменение поля не полностью определено. Например, если целевой объект представляет собой дату 31 января, а месяц изменится на февраль, то неясно, что должно произойти. В таких случаях поле отвечает за решение результата. Обычно выбирается предыдущая допустимая дата, что в данном примере будет последнее число февраля.

public HijrahDate with(TemporalAdjuster adjuster)

Возвращает скорректированный объект того же типа, что и этот объект, с внесённой корректировкой.

Этот метод корректирует текущую дату/время в соответствии с правилами указанного корректирующего элемента. Простой корректирующий элемент может просто задать одно из полей, например, год. Более сложный корректирующий элемент может установить дату на последнее число месяца. Выбор общих корректировок представлен в TemporalAdjusters. К ним относятся нахождение "последнего дня месяца" и "следующей среды". Корректирующий элемент отвечает за обработку специальных случаев, таких как переменная длина месяца и високосные годы.

Некоторые примеры кода, показывающие, как и почему используется этот метод:

  date = date.with(Month.JULY);        // most key classes implement TemporalAdjuster
  date = date.with(lastDayOfMonth());  // static import from Adjusters
  date = date.with(next(WEDNESDAY));   // static import from Adjusters and DayOfWeek
 

public HijrahDate withVariant(HijrahChronology chronology)

Возвращает дату HijrahDate с запрошенной хронологией.

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

public HijrahDate plus(TemporalAmount amount)

Возвращает объект того же типа, что и этот объект, с добавленной величиной.

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

Некоторые примеры кода, показывающие, как и почему используется этот метод:

  date = date.plus(period);                // add a Period instance
  date = date.plus(duration);              // add a Duration instance
  date = date.plus(workingDays(6));        // example user-written workingDays method
 

Обратите внимание, что вызов plus за которым следует minus не гарантирует возвращение той же даты и времени.

public HijrahDate minus(TemporalAmount amount)

Возвращает объект того же типа, что и этот объект, со значением, вычтенным.

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

Некоторые примеры кода, показывающие, как и почему используется этот метод:

  date = date.minus(period);               // subtract a Period instance
  date = date.minus(duration);             // subtract a Duration instance
  date = date.minus(workingDays(6));       // example user-written workingDays method
 

Обратите внимание, что вызов plus за которым следует minus не гарантирует возвращение той же даты и времени.

public boolean isLeapYear()

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

public HijrahDate plus(long amountToAdd, TemporalUnit unit)

Возвращает объект того же типа, что и этот объект, с добавленным указанным периодом.

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

В некоторых случаях изменение поля не полностью определено. Например, если целевой объект представляет дату 31 января, то добавление одного месяца будет неясно. В таких случаях поле отвечает за решение результата. Обычно оно выберет предыдущую допустимую дату, что в этом примере будет последним допустимым днем февраля.

public HijrahDate minus(long amountToSubtract, TemporalUnit unit)

Возвращает объект того же типа, что и этот объект, с указанным периодом, вычтенным.

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

В некоторых случаях изменение поля не полностью определено. Например, если целевой объект представляет дату 31 марта, то вычитание одного месяца будет неясно. В таких случаях поле отвечает за решение результата. Обычно оно выберет предыдущую допустимую дату, что в этом примере будет последним допустимым днем февраля.

public final ChronoLocalDateTime<HijrahDate> atTime(LocalTime localTime)

Объединяет эту дату со временем для создания ChronoLocalDateTime.

Это возвращает ChronoLocalDateTime, сформированный из этой даты в указанное время. Все возможные сочетания даты и времени допустимы.

public ChronoPeriod until(ChronoLocalDate endDate)

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

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

Точки начала и конца — this и указанная дата. Результат будет отрицательным, если конец находится до начала. Отрицательный знак будет одинаковым для каждого из года, месяца и дня.

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

Этот экземпляр неизменяем и не затрагивается этим вызовом метода.

public boolean equals(Object obj)

Сравнивает эту дату с другой датой, включая хронологию.

Сравнивает этот HijrahDate с другим, гарантируя, что дата совпадает.

Сравниваются только объекты типа HijrahDate, другие типы возвращают false. Для сравнения дат двух объектов TemporalAccessor , включая даты в двух разных хронологиях, используйте ChronoField.EPOCH_DAY в качестве компаратора.

public int hashCode()

Хеш-код для этой даты.

public long until(Temporal endExclusive, TemporalUnit unit)

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

Это вычисляет количество времени между двумя ChronoLocalDate объектами в терминах одной TemporalUnit. Точки начала и конца — это this и указанная дата. Результат будет отрицательным, если конец предшествует началу. Temporal , переданный в этот метод, преобразуется в ChronoLocalDate с помощью Chronology.date(TemporalAccessor). Вычисление возвращает целое число, представляющее количество полных единиц между двумя датами. Например, количество дней между двумя датами можно рассчитать с помощью startDate.until(endDate, DAYS).

Существует два эквивалентных способа использования этого метода. Первый — вызвать этот метод. Второй — использовать TemporalUnit.between(Temporal, Temporal):

   // these two lines are equivalent
   amount = start.until(end, MONTHS);
   amount = MONTHS.between(start, end);
 

Выбор должен быть сделан на основе того, что делает код более читаемым.

Вычисление реализовано в этом методе для ChronoUnit. Единицы DAYS, WEEKS, MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA и ERAS должны поддерживаться всеми реализациями. Другие значения ChronoUnit будут выбрасывать исключение.

Если единица измерения не является ChronoUnit, то результат этого метода получается путем вызова TemporalUnit.between(Temporal, Temporal) , передавая this в качестве первого аргумента и преобразованное временное значение ввода в качестве второго аргумента.

Этот экземпляр неизменяемый и не изменяется в результате вызова этого метода.

public String toString()

Возвращает строковое представление объекта.