Класс 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 из временного объекта.

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

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

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

public HijrahChronology getChronology()

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

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

public HijrahEra getEra()

Получает эпоху, применимую к этой дате.

В исламском календаре существует одна эпоха 'AH', определенная в HijrahEra.

public int lengthOfMonth()

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

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

public int lengthOfYear()

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

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

public long getLong(TemporalField field)

Получает значение указанного поля как long.

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

public HijrahDate with(TemporalField field, long newValue)

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

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

В некоторых случаях изменение поля не полностью определено. Например, если целевой объект представляет собой дату 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()

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