Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class ThaiBuddhistDate extends Object implements ChronoLocalDate<ThaiBuddhistDate>, Serializable
Эта дата управляет использованием тайского буддистского календаря. Эта календарная система прежде всего используется в Таиланде. Даты выровненные так, что 2484-01-01 (Buddhist)
1941-01-01 (ISO)
.
Модификатор и Тип | Метод и Описание |
---|---|
ChronoLocalDateTime<ThaiBuddhistDate> |
atTime(LocalTime localTime)
Комбинирует эту дату со временем, чтобы создать a
ChronoLocalDateTime . |
boolean |
equals(Object obj)
Указывает, " ли некоторый другой объект равен" этому.
|
static ThaiBuddhistDate |
from(TemporalAccessor temporal)
Получает a
ThaiBuddhistDate от временного объекта. |
ThaiBuddhistChronology |
getChronology()
Получает хронологию этой даты, которая является тайской буддистской календарной системой.
|
ThaiBuddhistEra |
getEra()
Получает эру, применимую в этой дате.
|
long |
getLong(TemporalField field)
Получает значение указанного поля как a
long . |
int |
hashCode()
Возвращает значение хэш-кода для объекта.
|
int |
lengthOfMonth()
Возвращает продолжительность месяца, представленного этой датой.
|
ThaiBuddhistDate |
minus(long amountToAdd, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с вычтенным установленным периодом.
|
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)
Получает a
ThaiBuddhistDate представляя дату в тайской буддистской календарной системе от преждевременно-летнего, месяц-летнего и дневные-месячного поля. |
Период |
periodUntil(ChronoLocalDate<?> endDate)
Вычисляет период между этой датой и другой датой как a
Period . |
long |
periodUntil(Temporal endDateTime, TemporalUnit unit)
Вычисляет количество времени до другой даты с точки зрения указанного модуля.
|
ThaiBuddhistDate |
plus(long amountToAdd, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с добавленным установленным периодом.
|
ThaiBuddhistDate |
plus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с добавленным количеством.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
long |
toEpochDay()
Преобразовывает эту дату в День Эпохи.
|
Строка |
toString()
Возвращает строковое представление объекта.
|
ThaiBuddhistDate |
with(TemporalAdjuster adjuster)
Возвращает скорректированный объект того же самого типа как этот объект с внесенной корректировкой.
|
ThaiBuddhistDate |
with(TemporalField field, long newValue)
Возвращает объект того же самого типа как этот объект с указанным измененным полем.
|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
adjustInto, compareTo, format, isAfter, isBefore, isEqual, isLeapYear, isSupported, lengthOfYear, periodUntil, query, timeLineOrder, toString
добраться
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
public static ThaiBuddhistDate now()
ThaiBuddhistDate
от системы начинают работу часовой пояс значения по умолчанию. Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущую дату.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static ThaiBuddhistDate now(ZoneId zone)
ThaiBuddhistDate
от системы начинают работу указанный часовой пояс. Это запросит system clock
получить текущую дату. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static ThaiBuddhistDate now(Clock clock)
ThaiBuddhistDate
от указанных часов. Это запросит указанные часы, чтобы получить текущую дату - сегодня. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя внедрение зависимости.
clock
- часы, чтобы использовать, не нульDateTimeException
- если текущая дата не может быть полученаpublic static ThaiBuddhistDate of(int prolepticYear, int month, int dayOfMonth)
ThaiBuddhistDate
представляя дату в тайской буддистской календарной системе от преждевременно-летнего, месяц-летнего и дневные-месячного поля. Это возвращает a ThaiBuddhistDate
с указанными полями. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
prolepticYear
- тайский преждевременно-летний буддистmonth
- тайский буддистский месяц-летнего, от 1 до 12dayOfMonth
- тайский буддистский день-месячного, от 1 до 31DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static ThaiBuddhistDate from(TemporalAccessor temporal)
ThaiBuddhistDate
от временного объекта. Это получает дату в тайской буддистской календарной системе, основанной на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр ThaiBuddhistDate
.
Преобразование обычно использует EPOCH_DAY
поле, которое стандартизируется через календарные системы.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, ThaiBuddhistDate::from
.
from
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a ThaiBuddhistDate
Chronology.date(TemporalAccessor)
public ThaiBuddhistChronology getChronology()
Chronology
представляет календарную систему в использовании. Эра и другие поля в ChronoField
определяются хронологией.
getChronology
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
public ThaiBuddhistEra getEra()
У тайской буддистской календарной системы есть две эры, 'BE' и 'BEFORE_BE', определенный ThaiBuddhistEra
.
getEra
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
public int lengthOfMonth()
Это возвращает продолжительность месяца в днях. Длины месяца соответствуют таковые из календарной системы ISO.
lengthOfMonth
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
public ValueRange range(TemporalField field)
TemporalAccessor
Все поля могут быть выражены как a long
целое число. Этот метод возвращает объект, который описывает допустимый диапазон для того значения. Значение этого временного объекта используется, чтобы улучшить точность возвращенного диапазона. Если разовое датой не может возвратить диапазон, потому что поле неподдерживается или по некоторой другой причине, исключение будет выдано.
Отметьте, что результат только описывает минимальные и максимальные допустимые значения, и важно не читать слишком много в них. Например, могли быть значения в пределах диапазона, которые недопустимы для поля.
range
в интерфейсе TemporalAccessor
field
- поле, чтобы запросить диапазон для, не нульpublic long getLong(TemporalField field)
TemporalAccessor
long
. Это запрашивает разовое датой для значения для указанного поля. Возвращенное значение может быть вне допустимого диапазона значений для поля. Если разовое датой не может возвратить значение, потому что поле неподдерживается или по некоторой другой причине, исключение будет выдано.
getLong
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульpublic ThaiBuddhistDate with(TemporalField field, long newValue)
ChronoLocalDate
Это возвращает новое основанное на объектах на этом со значением для указанного измененного поля. Например, на a LocalDate
, это могло использоваться, чтобы установить год, месяц или день-месячного. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если целевой объект является датой, представляющей 31-ого января, то изменение месяца до февраля было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
with
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеpublic ThaiBuddhistDate with(TemporalAdjuster adjuster)
Это корректирует это разовое датой согласно правилам указанного регулятора. Простой регулятор мог бы просто установить то из полей, таких как поле года. Более сложный регулятор мог бы назначить дату к прошлому дню месяца. В выборе общих корректировок обеспечивают TemporalAdjuster
. Они включают обнаружение "в последний день месяца" и "следующей среды". Регулятор ответственен за обработку особых случаев, таких как переменные продолжительности месяца и високосных годов.
Некоторый пример кода, указывающий, как и почему этот метод используется:
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<ThaiBuddhistDate>
with
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитpublic ThaiBuddhistDate plus(TemporalAmount amount)
Это корректирует это временное, добавляя согласно правилам указанного количества. Количество обычно a 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<ThaiBuddhistDate>
plus
в интерфейсе Temporal
amount
- количество, чтобы добавить, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic ThaiBuddhistDate minus(TemporalAmount amount)
Это корректирует это временное, вычитая согласно правилам указанного количества. Количество обычно a 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<ThaiBuddhistDate>
minus
в интерфейсе Temporal
amount
- количество, чтобы вычесть, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic ThaiBuddhistDate plus(long amountToAdd, TemporalUnit unit)
ChronoLocalDate
Этот метод возвращает новое основанное на объектах на этом с добавленным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы добавить много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого января, то добавление одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
plus
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
plus
в интерфейсе Temporal
amountToAdd
- количество указанного модуля, чтобы добавить, может быть отрицательнымunit
- модуль периода, чтобы добавить, не нульpublic ThaiBuddhistDate minus(long amountToAdd, TemporalUnit unit)
ChronoLocalDate
Этот метод возвращает новое основанное на объектах на этом с вычтенным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы вычесть много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого марта, то вычитание одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
minus
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
minus
в интерфейсе Temporal
amountToAdd
- количество указанного модуля, чтобы вычесть, может быть отрицательнымunit
- модуль периода, чтобы вычесть, не нульpublic final ChronoLocalDateTime<ThaiBuddhistDate> atTime(LocalTime localTime)
ChronoLocalDate
ChronoLocalDateTime
. Это возвращает a ChronoLocalDateTime
сформированный из этой даты в требуемое время. Все возможные комбинации даты и время допустимы.
atTime
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
localTime
- местное время, чтобы использовать, не нульpublic Period periodUntil(ChronoLocalDate<?> endDate)
ChronoLocalDate
Period
. Это вычисляет период между двумя датами с точки зрения лет, месяцев и дней. Запуск и конечные точки this
и указанная дата. Результат будет отрицателен, если конец будет перед запуском. Знак минус будет тем же самым в каждом годе, месяце и дне.
Вычисление выполняется, используя хронологию этой даты. В случае необходимости входная дата будет преобразована в соответствие.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
endDate
- дата окончания, монопольная, который может быть в любой хронологии, не нулеpublic long toEpochDay()
ChronoLocalDate
Epoch Day count
простое количество постепенного увеличения дней, где день 0 01.01.1970 (ISO). Это определение является тем же самым для всех хронологий, включая преобразованию.
Эта реализация по умолчанию запрашивает EPOCH_DAY
поле.
toEpochDay
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
public boolean equals(Object obj)
Object
equals
метод реализует отношение эквивалентности на ненулевых ссылках на объект:
x
, x.equals(x)
должен возвратиться true
. x
и y
, x.equals(y)
должен возвратиться true
если и только если y.equals(x)
возвраты true
. x
, y
, и z
, если x.equals(y)
возвраты true
и y.equals(z)
возвраты true
, тогда x.equals(z)
должен возвратиться true
. x
и y
, многократные вызовы x.equals(y)
последовательно возвращайтесь true
или последовательно возвращайтесь false
, предоставленный никакая информация, используемая в equals
сравнения на объектах изменяются. x
, x.equals(null)
должен возвратиться false
. equals
метод для class Object
реализует самое отличительное отношение эквивалентности на объектах; то есть, для любых ненулевых ссылочных значений x
и y
, этот метод возвраты true
если и только если x
и y
обратитесь к тому же самому объекту (x == y
имеет значение true
).
Отметьте, что обычно необходимо переопределить hashCode
метод всякий раз, когда этот метод переопределяется, чтобы поддержать общий контракт для hashCode
метод, который утверждает, что у равных объектов должны быть равные хэш-коды.
equals
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
obj
- ссылочный объект, с которым можно сравниться.true
если этот объект является тем же самым как obj параметром; false
иначе.Object.hashCode()
, HashMap
public int hashCode()
Object
HashMap
. Общий контракт hashCode
:
hashCode
метод должен последовательно возвращать то же самое целое число, не предоставил информации, используемой в equals
сравнения на объекте изменяются. Эта целочисленная потребность не остается непротиворечивой от одного выполнения приложения к другому выполнению того же самого приложения. equals(Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к тому же самому целочисленному результату. Object.equals(java.lang.Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к отличным целочисленным результатам. Однако, программист должен знать, что приведение к отличным целочисленным результатам для неравных объектов может улучшить производительность хэш-таблиц. Столько, сколько разумно практично, метод хэш-кода, определенный class Object
действительно возвращает отличные целые числа для отличных объектов. (Это обычно реализуется, преобразовывая внутренний адрес объекта в целое число, но этот метод реализации не требуется языком программирования Java™.)
hashCode
в интерфейсе ChronoLocalDate<ThaiBuddhistDate>
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public long periodUntil(Temporal endDateTime, TemporalUnit unit)
Это вычисляет количество времени между два ChronoLocalDate
объекты с точки зрения сингла TemporalUnit
. Запуск и конечные точки this
и указанная дата. Результат будет отрицателен, если конец будет перед запуском. Temporal
переданный к этому методу должен быть a ChronoLocalDate
в той же самой хронологии. Вычисление возвращает целое число, представляя число полных модулей между этими двумя датами. Например, количество в днях между двумя датами может быть вычислено, используя startDate.periodUntil(endDate, DAYS)
.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать TemporalUnit.between(Temporal, Temporal)
:
// these two lines are equivalent amount = start.periodUntil(end, MONTHS); amount = MONTHS.between(start, end);Выбор должен быть сделан основанный, которого делает код более читаемым.
Вычисление реализуется в этом методе для ChronoUnit
. Модули DAYS
, WEEKS
, MONTHS
, YEARS
, DECADES
, CENTURIES
, MILLENNIA
и ERAS
должен поддерживаться всеми реализациями. Другой ChronoUnit
значения выдадут исключение.
Если модуль не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.between(Temporal, Temporal)
передача this
как первый параметр и ввод, временный как второй параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе ChronoLocalDate<D extends ChronoLocalDate<D>>
periodUntil
в интерфейсе Temporal
endDateTime
- дата окончания, которая должна быть a ChronoLocalDate
в той же самой хронологии, не нулеunit
- модуль, чтобы измерить количество в, не нульDateTimeException
- если количество не может быть вычисленоArithmeticException
- если числовое переполнение происходитpublic String toString()
Object
toString
метод возвращает строку, которая "дословно представляет" этот объект. Результатом должно быть краткое, но информативное представление, которое легко для человека читать. Рекомендуется, чтобы все подклассы переопределили этот метод. toString
метод для class Object
возвращает строку, состоящую из имени class, которого объект является экземпляром, символ знака at-sign`@
', и шестнадцатеричное представление без знака хэш-кода объекта. Другими словами этот метод возвращает строку, равную значению:
getClass().getName() + '@' + Integer.toHexString(hashCode())
toString
в интерфейсе ChronoLocalDate<D extends ChronoLocalDate<D>>
toString
в class Object
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92