Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class MinguoDate extends Object implements ChronoLocalDate<MinguoDate>, Serializable
Эта дата управляет использованием календаря Minguo. Эта календарная система прежде всего используется в республике Китая, часто известного как Тайвань. Даты выровненные так, что 0001-01-01 (Minguo)
1912-01-01 (ISO)
.
Модификатор и Тип | Метод и Описание |
---|---|
ChronoLocalDateTime<MinguoDate> |
atTime(LocalTime localTime)
Комбинирует эту дату со временем, чтобы создать a
ChronoLocalDateTime . |
boolean |
equals(Object obj)
Указывает, " ли некоторый другой объект равен" этому.
|
static MinguoDate |
from(TemporalAccessor temporal)
Получает a
MinguoDate от временного объекта. |
MinguoChronology |
getChronology()
Получает хронологию этой даты, которая является календарной системой Minguo.
|
MinguoEra |
getEra()
Получает эру, применимую в этой дате.
|
long |
getLong(TemporalField field)
Получает значение указанного поля как a
long . |
int |
hashCode()
Возвращает значение хэш-кода для объекта.
|
int |
lengthOfMonth()
Возвращает продолжительность месяца, представленного этой датой.
|
MinguoDate |
minus(long amountToAdd, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с вычтенным установленным периодом.
|
MinguoDate |
minus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с вычтенным количеством.
|
static MinguoDate |
now()
Получает ток
MinguoDate от системы начинают работу часовой пояс значения по умолчанию. |
static MinguoDate |
now(Clock clock)
Получает ток
MinguoDate от указанных часов. |
static MinguoDate |
now(ZoneId zone)
Получает ток
MinguoDate от системы начинают работу указанный часовой пояс. |
static MinguoDate |
of(int prolepticYear, int month, int dayOfMonth)
Получает a
MinguoDate представляя дату в календарной системе Minguo от преждевременно-летнего, месяц-летнего и дневные-месячного поля. |
Период |
periodUntil(ChronoLocalDate<?> endDate)
Вычисляет период между этой датой и другой датой как a
Period . |
long |
periodUntil(Temporal endDateTime, TemporalUnit unit)
Вычисляет количество времени до другой даты с точки зрения указанного модуля.
|
MinguoDate |
plus(long amountToAdd, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с добавленным установленным периодом.
|
MinguoDate |
plus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с добавленным количеством.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
long |
toEpochDay()
Преобразовывает эту дату в День Эпохи.
|
Строка |
toString()
Возвращает строковое представление объекта.
|
MinguoDate |
with(TemporalAdjuster adjuster)
Возвращает скорректированный объект того же самого типа как этот объект с внесенной корректировкой.
|
MinguoDate |
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 MinguoDate now()
MinguoDate
от системы начинают работу часовой пояс значения по умолчанию. Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущую дату.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static MinguoDate now(ZoneId zone)
MinguoDate
от системы начинают работу указанный часовой пояс. Это запросит system clock
получить текущую дату. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static MinguoDate now(Clock clock)
MinguoDate
от указанных часов. Это запросит указанные часы, чтобы получить текущую дату - сегодня. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя внедрение зависимости.
clock
- часы, чтобы использовать, не нульDateTimeException
- если текущая дата не может быть полученаpublic static MinguoDate of(int prolepticYear, int month, int dayOfMonth)
MinguoDate
представляя дату в календарной системе Minguo от преждевременно-летнего, месяц-летнего и дневные-месячного поля. Это возвращает a MinguoDate
с указанными полями. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
prolepticYear
- преждевременно-летний Minguomonth
- месяц-летнего Minguo, от 1 до 12dayOfMonth
- день-месячного Minguo, от 1 до 31DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static MinguoDate from(TemporalAccessor temporal)
MinguoDate
от временного объекта. Это получает дату в календарной системе Minguo, основанной на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр MinguoDate
.
Преобразование обычно использует EPOCH_DAY
поле, которое стандартизируется через календарные системы.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, MinguoDate::from
.
from
в интерфейсе ChronoLocalDate<MinguoDate>
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a MinguoDate
Chronology.date(TemporalAccessor)
public MinguoChronology getChronology()
Chronology
представляет календарную систему в использовании. Эра и другие поля в ChronoField
определяются хронологией.
getChronology
в интерфейсе ChronoLocalDate<MinguoDate>
public MinguoEra getEra()
У календарной системы Minguo есть две эры, 'ПТИЦА РУХ' и 'BEFORE_ROC', определенный MinguoEra
.
getEra
в интерфейсе ChronoLocalDate<MinguoDate>
public int lengthOfMonth()
Это возвращает продолжительность месяца в днях. Длины месяца соответствуют таковые из календарной системы ISO.
lengthOfMonth
в интерфейсе ChronoLocalDate<MinguoDate>
public ValueRange range(TemporalField field)
TemporalAccessor
Все поля могут быть выражены как a long
целое число. Этот метод возвращает объект, который описывает допустимый диапазон для того значения. Значение этого временного объекта используется, чтобы улучшить точность возвращенного диапазона. Если разовое датой не может возвратить диапазон, потому что поле неподдерживается или по некоторой другой причине, исключение будет выдано.
Отметьте, что результат только описывает минимальные и максимальные допустимые значения, и важно не читать слишком много в них. Например, могли быть значения в пределах диапазона, которые недопустимы для поля.
range
в интерфейсе TemporalAccessor
field
- поле, чтобы запросить диапазон для, не нульpublic long getLong(TemporalField field)
TemporalAccessor
long
. Это запрашивает разовое датой для значения для указанного поля. Возвращенное значение может быть вне допустимого диапазона значений для поля. Если разовое датой не может возвратить значение, потому что поле неподдерживается или по некоторой другой причине, исключение будет выдано.
getLong
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульpublic MinguoDate with(TemporalField field, long newValue)
ChronoLocalDate
Это возвращает новое основанное на объектах на этом со значением для указанного измененного поля. Например, на a LocalDate
, это могло использоваться, чтобы установить год, месяц или день-месячного. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если целевой объект является датой, представляющей 31-ого января, то изменение месяца до февраля было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
with
в интерфейсе ChronoLocalDate<MinguoDate>
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеpublic MinguoDate 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<MinguoDate>
with
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитpublic MinguoDate 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<MinguoDate>
plus
в интерфейсе Temporal
amount
- количество, чтобы добавить, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic MinguoDate 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<MinguoDate>
minus
в интерфейсе Temporal
amount
- количество, чтобы вычесть, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic MinguoDate plus(long amountToAdd, TemporalUnit unit)
ChronoLocalDate
Этот метод возвращает новое основанное на объектах на этом с добавленным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы добавить много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого января, то добавление одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
plus
в интерфейсе ChronoLocalDate<MinguoDate>
plus
в интерфейсе Temporal
amountToAdd
- количество указанного модуля, чтобы добавить, может быть отрицательнымunit
- модуль периода, чтобы добавить, не нульpublic MinguoDate minus(long amountToAdd, TemporalUnit unit)
ChronoLocalDate
Этот метод возвращает новое основанное на объектах на этом с вычтенным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы вычесть много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого марта, то вычитание одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
minus
в интерфейсе ChronoLocalDate<MinguoDate>
minus
в интерфейсе Temporal
amountToAdd
- количество указанного модуля, чтобы вычесть, может быть отрицательнымunit
- модуль периода, чтобы вычесть, не нульpublic final ChronoLocalDateTime<MinguoDate> atTime(LocalTime localTime)
ChronoLocalDate
ChronoLocalDateTime
. Это возвращает a ChronoLocalDateTime
сформированный из этой даты в требуемое время. Все возможные комбинации даты и время допустимы.
atTime
в интерфейсе ChronoLocalDate<MinguoDate>
localTime
- местное время, чтобы использовать, не нульpublic Period periodUntil(ChronoLocalDate<?> endDate)
ChronoLocalDate
Period
. Это вычисляет период между двумя датами с точки зрения лет, месяцев и дней. Запуск и конечные точки this
и указанная дата. Результат будет отрицателен, если конец будет перед запуском. Знак минус будет тем же самым в каждом годе, месяце и дне.
Вычисление выполняется, используя хронологию этой даты. В случае необходимости входная дата будет преобразована в соответствие.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе ChronoLocalDate<MinguoDate>
endDate
- дата окончания, монопольная, который может быть в любой хронологии, не нулеpublic long toEpochDay()
ChronoLocalDate
Epoch Day count
простое количество постепенного увеличения дней, где день 0 01.01.1970 (ISO). Это определение является тем же самым для всех хронологий, включая преобразованию.
Эта реализация по умолчанию запрашивает EPOCH_DAY
поле.
toEpochDay
в интерфейсе ChronoLocalDate<MinguoDate>
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<MinguoDate>
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<MinguoDate>
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