Класс 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.

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