Класс ThaiBuddhistDate

Все реализуемые интерфейсы:
Serializable, Comparable<ChronoLocalDate>, ChronoLocalDate, Temporal, TemporalAccessor, TemporalAdjuster 
public final class ThaiBuddhistDate
extends Object
implements ChronoLocalDate, Serializable

Дата в системе календаря тайского буддизма.

Эта дата работает с использованием календаря тайского буддизма. Эта система календаря используется в основном в Таиланде. Даты выровнены таким образом, что 2484-01-01 (Buddhist) является 1941-01-01 (ISO).

Это классовое значение; использование операций, чувствительных к идентификатору (включая равенство ссылок (==), хэш-код идентификатора или синхронизацию) на экземплярах ThaiBuddhistDate может привести к непредсказуемым результатам и следует избегать. Следует использовать метод equals для сравнений.

Требования к реализации:
Этот класс неизменяемый и потокобезопасный.
С:
1.8
См. также:
Сериализованная форма

Методы

Модификатор и тип Метод Описание
boolean equals​(Object obj)

Сравнивает эту дату с другой датой, включая хронологию.
static ThaiBuddhistDate from​(TemporalAccessor temporal)

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

Получает хронологию этой даты, которая является системой календаря тайского буддизма.
ThaiBuddhistEra getEra()

Получает эру, применимую в эту дату.
int hashCode()

Хэш-код для этой даты.
int lengthOfMonth()

Возвращает длительность месяца, представленного этой датой.
ThaiBuddhistDate minus​(TemporalAmount amount)

Возвращает объект того же типа, что и этот объект, со вычетом количества.
static ThaiBuddhistDate now()

Получает текущую ThaiBuddhistDate из системных часов в часовом поясе по умолчанию.
static ThaiBuddhistDate now​(Clock clock)

Получает текущую ThaiBuddhistDate из указанных часов.
static ThaiBuddhistDate now​(ZoneId zone)

Получает текущую ThaiBuddhistDate из системных часов в указанном часовом поясе.
static ThaiBuddhistDate of​(int prolepticYear, int month, int dayOfMonth)

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

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

Возвращает строковое представление объекта.
long until​(Temporal endExclusive, TemporalUnit unit)

Вычисляет временной интервал до другой даты в терминах указанного интервала времени.
ThaiBuddhistDate with​(TemporalAdjuster adjuster)

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

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.time.chrono.ChronoLocalDate

adjustInto, atTime, compareTo, format, isAfter, isBefore, isEqual, isLeapYear, isSupported, isSupported, lengthOfYear, minus, plus, query, toEpochDay, toString, until, until, with

Методы, объявленные в интерфейсе java.time.temporal.TemporalAccessor

get, getLong, range

Методы

now

public static ThaiBuddhistDate now()

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

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

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

Возвращает:
текущую дату с использованием системных часов и часового пояса по умолчанию, не null

now

public static ThaiBuddhistDate now(ZoneId zone)

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

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

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

Параметры:
zone - идентификатор часового пояса для использования, не null
Возвращает:
текущую дату с использованием системных часов, не null

now

public static ThaiBuddhistDate now(Clock clock)

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

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

Параметры:
clock - часы для использования, не null
Возвращает:
текущую дату, не null
Выбрасывает:
DateTimeException - если текущая дата не может быть получена

of

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

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

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

Параметры:
prolepticYear - пролептический год тайского буддийского календаря
month - месяц тайского буддийского календаря, от 1 до 12
dayOfMonth - день тайского буддийского календаря, от 1 до 31
Возвращает:
дату в системе тайского буддийского календаря, не null
Выбрасывает:
DateTimeException - если значение любого поля находится вне диапазона или если день месяца недопустим для месяца и года

from

public static ThaiBuddhistDate from(TemporalAccessor temporal)

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

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

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

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

Параметры:
temporal - временной объект для преобразования, не null
Возвращает:
дату в системе тайского буддийского календаря, не null
Выбрасывает:
DateTimeException - если невозможно преобразовать в ThaiBuddhistDate
См. также:
Chronology.date(TemporalAccessor)

getChronology

public ThaiBuddhistChronology getChronology()

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

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

Определено в:
getChronology в интерфейсе ChronoLocalDate
Возвращает:
хронологию тайского буддийского календаря, не null

getEra

public ThaiBuddhistEra getEra()

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

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

Определено в:
getEra в интерфейсе ChronoLocalDate
Возвращает:
эпоху, применимую к этой дате, не null

lengthOfMonth

public int lengthOfMonth()

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

Это возвращает длину месяца в днях. Длины месяцев соответствуют длинам месяцев в системе ISO-календаря.

Определено в:
lengthOfMonth в интерфейсе ChronoLocalDate
Возвращает:
длину месяца в днях

with

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
Определено в:
with в интерфейсе ChronoLocalDate
Определено в:
with в интерфейсе Temporal
Параметры:
adjuster - корректирующий элемент для использования, не null
Возвращает:
объект того же типа с выполненной указанной корректировкой, не null
Выбрасывает:
DateTimeException - если корректировка не может быть выполнена
ArithmeticException - если происходит переполнение числового значения

plus

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 не гарантирует возвращение той же даты-времени.

Определено в:
plus в интерфейсе ChronoLocalDate
Определено в:
plus в интерфейсе Temporal
Параметры:
amount - величина для добавления, не null
Возвращает:
объект того же типа с выполненной указанной корректировкой, не null
Выбрасывает:
DateTimeException - если добавление не может быть выполнено
ArithmeticException - если происходит переполнение числового значения

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 не гарантирует возвращение той же даты-времени.

Определено в:
minus в интерфейсе ChronoLocalDate
Определено в:
minus в интерфейсе Temporal
Параметры:
amount - величина для вычитания, не null
Возвращает:
объект того же типа с выполненной указанной корректировкой, не null
Выбрасывает:
DateTimeException - если вычитание не может быть выполнено
ArithmeticException - если происходит переполнение числового значения

equals

public boolean equals(Object obj)

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

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

Сравниваются только объекты типа ThaiBuddhistDate, другие типы возвращают false. Для сравнения дат двух TemporalAccessor экземпляров, включая даты в двух разных хронологиях, используйте ChronoField.EPOCH_DAY в качестве компаратора.

Определено в:
equals в интерфейсе ChronoLocalDate
Параметры:
obj - объект для проверки, null возвращает false
Возвращает:
true, если эта дата равна другой дате
См. также:
Object.hashCode(), HashMap

hashCode

public int hashCode()

Хэш-код этой даты.

Определено в:
hashCode в интерфейсе ChronoLocalDate
Возвращает:
подходящий хэш-код, основанный только на хронологии и дате
См. также:
Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

until

public long until(Temporal endExclusive,
                  TemporalUnit unit)

Описание скопировано из интерфейса: ChronoLocalDate

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

Это вычисляет количество времени между двумя 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 в качестве первого аргумента и преобразованный временной объект — во второй.

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

Указано в:
until в интерфейсе ChronoLocalDate
Указано в:
until в интерфейсе Temporal
Параметры:
endExclusive - конечная дата, исключающая, преобразуется в ChronoLocalDate в той же хронологии, не null
unit - единица измерения для вычисления, не null
Возвращает:
количество времени между этой датой и конечной датой

toString

public String toString()

Описание скопировано из класса: Object

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

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

getClass().getName() + '@' + Integer.toHexString(hashCode())
Указано в:
toString в интерфейсе ChronoLocalDate
Переопределяет:
toString в классе Object
Возвращает:
строковое представление объекта.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/chrono/ThaiBuddhistDate.html

Spec-Zone .ru
спецификации, руководства, описания, API