Класс 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 ValueRange range(TemporalField field)

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

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

Обратите внимание, что результат описывает только минимальное и максимальное допустимые значения, и не стоит слишком глубоко их интерпретировать. Например, могут быть значения в диапазоне, которые являются недопустимыми для поля.

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 amountToAdd,
                              TemporalUnit unit)

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

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

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

public final ChronoLocalDateTime<ThaiBuddhistDate> atTime(LocalTime localTime)

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

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

public ChronoPeriod until(ChronoLocalDate endDate)

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

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

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

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

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

public long toEpochDay()

Преобразует эту дату в Эпоху Дня.

Epoch Day count — это простая нарастающая счетчик дней, где день 0 — 1970-01-01 (ISO). Это определение одинаково для всех хронологий, что позволяет выполнить преобразование.

Эта реализация по умолчанию запрашивает поле EPOCH_DAY.

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()

Возвращает строковое представление объекта. В общем случае, метод toString возвращает строку, которая «текстово представляет» этот объект. Результат должен быть кратким, но информативным представлением, легко читаемым человеком. Рекомендуется, чтобы все подклассы переопределяли этот метод.

Метод toString для класса Object возвращает строку, состоящую из имени класса, к которому относится объект, символа «@» и беззнакового шестнадцатеричного представления хэш-кода объекта. Другими словами, этот метод возвращает строку, равную значению:

getClass().getName() + '@' + Integer.toHexString(hashCode())