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

Вывод будет включать полную локальную дату.