Класс ThaiBuddhistDate

public static ThaiBuddhistDate now()

Получает текущую ThaiBuddhistDate по системным часам в часовом поясе по умолчанию.

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

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

public static ThaiBuddhistDate now(ZoneId zone)

Получает текущую ThaiBuddhistDate по системным часам в указанном часовом поясе.

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

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

public static ThaiBuddhistDate now(Clock clock)

Получает текущую ThaiBuddhistDate по указанным часам.

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

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

Получает ThaiBuddhistDate, представляющую дату в тайской буддийской календарной системе, из полей пролептического года, месяца года и дня месяца.

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

public static ThaiBuddhistDate from(TemporalAccessor temporal)

Получает ThaiBuddhistDate из временного объекта.

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

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

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

public ThaiBuddhistChronology getChronology()

Получает хронологию этой даты — тайскую буддийскую календарную систему.

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

public ThaiBuddhistEra getEra()

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

Тайская буддийская календарная система имеет две эры — «BE» и «BEFORE_BE», определенные в ThaiBuddhistEra.

public int lengthOfMonth()

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

Возвращает длину месяца в днях. Продолжительность месяцев совпадает с продолжительностью месяцев в календарной системе ISO.

public long getLong(TemporalField field)

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

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

public ThaiBuddhistDate with(TemporalField field, long newValue)

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

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

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

public ThaiBuddhistDate 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 ThaiBuddhistDate 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 ThaiBuddhistDate 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 ThaiBuddhistDate plus(long amountToAdd, TemporalUnit unit)

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

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

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

public ThaiBuddhistDate minus(long amountToSubtract, TemporalUnit unit)

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

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

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

public final ChronoLocalDateTime<ThaiBuddhistDate> atTime(LocalTime localTime)

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

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

public ChronoPeriod until(ChronoLocalDate endDate)

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

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

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

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

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

public boolean equals(Object obj)

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

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

Сравниваются только объекты типа ThaiBuddhistDate; для других типов возвращается 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()

Выводит эту дату в виде String.

Вывод будет содержать полную местную дату.