Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class JapaneseDate extends Object implements ChronoLocalDate<JapaneseDate>, Serializable
Эта дата управляет использованием японского Имперского календаря. Эта календарная система прежде всего используется в Японии.
Японская Имперская календарная система является тем же самым как календарной системой ISO кроме основанного на эре года, нумеруя. Преждевременно-летнее определяется, чтобы быть равным преждевременно-летнему ISO.
Например, японский год "Heisei 24" соответствует году ISO "2012".
Вызов japaneseDate.get(YEAR_OF_ERA)
возвратится 24.
Вызов japaneseDate.get(YEAR)
возвратит 2012.
Вызов japaneseDate.get(ERA)
возвратится 2, соответствуя JapaneseChronology.ERA_HEISEI
.
Модификатор и Тип | Метод и Описание |
---|---|
ChronoLocalDateTime<JapaneseDate> |
atTime(LocalTime localTime)
Комбинирует эту дату со временем, чтобы создать a
ChronoLocalDateTime . |
boolean |
equals(Object obj)
Указывает, " ли некоторый другой объект равен" этому.
|
static JapaneseDate |
from(TemporalAccessor temporal)
Получает a
JapaneseDate от временного объекта. |
JapaneseChronology |
getChronology()
Получает хронологию этой даты, которая является японской календарной системой.
|
JapaneseEra |
getEra()
Получает эру, применимую в этой дате.
|
long |
getLong(TemporalField field)
Получает значение указанного поля как a
long . |
int |
hashCode()
Возвращает значение хэш-кода для объекта.
|
int |
lengthOfMonth()
Возвращает продолжительность месяца, представленного этой датой.
|
JapaneseDate |
minus(long amountToAdd, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с вычтенным установленным периодом.
|
JapaneseDate |
minus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с вычтенным количеством.
|
static JapaneseDate |
now()
Получает ток
JapaneseDate от системы начинают работу часовой пояс значения по умолчанию. |
static JapaneseDate |
now(Clock clock)
Получает ток
JapaneseDate от указанных часов. |
static JapaneseDate |
now(ZoneId zone)
Получает ток
JapaneseDate от системы начинают работу указанный часовой пояс. |
static JapaneseDate |
of(Era era, int yearOfEra, int month, int dayOfMonth)
Получает a
JapaneseDate представляя дату в японской календарной системе с эры, года эры, месяца-летнего и дневных-месячного полей. |
static JapaneseDate |
of(int prolepticYear, int month, int dayOfMonth)
Получает a
JapaneseDate представляя дату в японской календарной системе от преждевременно-летнего, месяц-летнего и дневные-месячного поля. |
static JapaneseDate |
ofYearDay(int prolepticYear, int dayOfYear)
Получает a
JapaneseDate представление даты в японской календарной системе от преждевременно-летних полей и дневных-летнего полей. |
Период |
periodUntil(ChronoLocalDate<?> endDate)
Вычисляет период между этой датой и другой датой как a
Period . |
long |
periodUntil(Temporal endDateTime, TemporalUnit unit)
Вычисляет количество времени до другой даты с точки зрения указанного модуля.
|
JapaneseDate |
plus(long amountToAdd, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с добавленным установленным периодом.
|
JapaneseDate |
plus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с добавленным количеством.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
long |
toEpochDay()
Преобразовывает эту дату в День Эпохи.
|
Строка |
toString()
Возвращает строковое представление объекта.
|
JapaneseDate |
with(TemporalAdjuster adjuster)
Возвращает скорректированный объект того же самого типа как этот объект с внесенной корректировкой.
|
JapaneseDate |
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
добраться
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
public static JapaneseDate now()
JapaneseDate
от системы начинают работу часовой пояс значения по умолчанию. Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущую дату.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static JapaneseDate now(ZoneId zone)
JapaneseDate
от системы начинают работу указанный часовой пояс. Это запросит system clock
получить текущую дату. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static JapaneseDate now(Clock clock)
JapaneseDate
от указанных часов. Это запросит указанные часы, чтобы получить текущую дату - сегодня. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя внедрение зависимости.
clock
- часы, чтобы использовать, не нульDateTimeException
- если текущая дата не может быть полученаpublic static JapaneseDate of(Era era, int yearOfEra, int month, int dayOfMonth)
JapaneseDate
представляя дату в японской календарной системе с эры, года эры, месяца-летнего и дневных-месячного полей. Это возвращает a JapaneseDate
с указанными полями. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
era
- японская эра, не нульyearOfEra
- японский год эрыmonth
- японский месяц-летнего, от 1 до 12dayOfMonth
- японский день-месячного, от 1 до 31DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцем, или если дата не является японской эройpublic static JapaneseDate of(int prolepticYear, int month, int dayOfMonth)
JapaneseDate
представляя дату в японской календарной системе от преждевременно-летнего, месяц-летнего и дневные-месячного поля. Это возвращает a JapaneseDate
с указанными полями. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
prolepticYear
- преждевременно-летние японцыmonth
- японский месяц-летнего, от 1 до 12dayOfMonth
- японский день-месячного, от 1 до 31DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static JapaneseDate ofYearDay(int prolepticYear, int dayOfYear)
JapaneseDate
представление даты в японской календарной системе от преждевременно-летних полей и дневных-летнего полей. Это возвращает a JapaneseDate
с указанными полями. День должен быть допустимым в течение года, иначе исключение будет выдано.
prolepticYear
- преждевременно-летняя хронологияdayOfYear
- день-летнего хронологии, от 1 до 366DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-летнего недопустим в течение годаpublic static JapaneseDate from(TemporalAccessor temporal)
JapaneseDate
от временного объекта. Это получает дату в японской календарной системе, основанной на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр JapaneseDate
.
Преобразование обычно использует EPOCH_DAY
поле, которое стандартизируется через календарные системы.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, JapaneseDate::from
.
from
в интерфейсе ChronoLocalDate<JapaneseDate>
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a JapaneseDate
Chronology.date(TemporalAccessor)
public JapaneseChronology getChronology()
Chronology
представляет календарную систему в использовании. Эра и другие поля в ChronoField
определяются хронологией.
getChronology
в интерфейсе ChronoLocalDate<JapaneseDate>
public JapaneseEra getEra()
Японской календарной системе определили многократные эры JapaneseEra
.
getEra
в интерфейсе ChronoLocalDate<JapaneseDate>
public int lengthOfMonth()
Это возвращает продолжительность месяца в днях. Длины месяца соответствуют таковые из календарной системы ISO.
lengthOfMonth
в интерфейсе ChronoLocalDate<JapaneseDate>
public ValueRange range(TemporalField field)
TemporalAccessor
Все поля могут быть выражены как a long
целое число. Этот метод возвращает объект, который описывает допустимый диапазон для того значения. Значение этого временного объекта используется, чтобы улучшить точность возвращенного диапазона. Если разовое датой не может возвратить диапазон, потому что поле неподдерживается или по некоторой другой причине, исключение будет выдано.
Отметьте, что результат только описывает минимальные и максимальные допустимые значения, и важно не читать слишком много в них. Например, могли быть значения в пределах диапазона, которые недопустимы для поля.
range
в интерфейсе TemporalAccessor
field
- поле, чтобы запросить диапазон для, не нульpublic long getLong(TemporalField field)
TemporalAccessor
long
. Это запрашивает разовое датой для значения для указанного поля. Возвращенное значение может быть вне допустимого диапазона значений для поля. Если разовое датой не может возвратить значение, потому что поле неподдерживается или по некоторой другой причине, исключение будет выдано.
getLong
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульpublic JapaneseDate with(TemporalField field, long newValue)
ChronoLocalDate
Это возвращает новое основанное на объектах на этом со значением для указанного измененного поля. Например, на a LocalDate
, это могло использоваться, чтобы установить год, месяц или день-месячного. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если целевой объект является датой, представляющей 31-ого января, то изменение месяца до февраля было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
with
в интерфейсе ChronoLocalDate<JapaneseDate>
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеpublic JapaneseDate 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<JapaneseDate>
with
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитpublic JapaneseDate 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<JapaneseDate>
plus
в интерфейсе Temporal
amount
- количество, чтобы добавить, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic JapaneseDate 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<JapaneseDate>
minus
в интерфейсе Temporal
amount
- количество, чтобы вычесть, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic JapaneseDate plus(long amountToAdd, TemporalUnit unit)
ChronoLocalDate
Этот метод возвращает новое основанное на объектах на этом с добавленным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы добавить много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого января, то добавление одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
plus
в интерфейсе ChronoLocalDate<JapaneseDate>
plus
в интерфейсе Temporal
amountToAdd
- количество указанного модуля, чтобы добавить, может быть отрицательнымunit
- модуль периода, чтобы добавить, не нульpublic JapaneseDate minus(long amountToAdd, TemporalUnit unit)
ChronoLocalDate
Этот метод возвращает новое основанное на объектах на этом с вычтенным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы вычесть много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого марта, то вычитание одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
minus
в интерфейсе ChronoLocalDate<JapaneseDate>
minus
в интерфейсе Temporal
amountToAdd
- количество указанного модуля, чтобы вычесть, может быть отрицательнымunit
- модуль периода, чтобы вычесть, не нульpublic final ChronoLocalDateTime<JapaneseDate> atTime(LocalTime localTime)
ChronoLocalDate
ChronoLocalDateTime
. Это возвращает a ChronoLocalDateTime
сформированный из этой даты в требуемое время. Все возможные комбинации даты и время допустимы.
atTime
в интерфейсе ChronoLocalDate<JapaneseDate>
localTime
- местное время, чтобы использовать, не нульpublic Period periodUntil(ChronoLocalDate<?> endDate)
ChronoLocalDate
Period
. Это вычисляет период между двумя датами с точки зрения лет, месяцев и дней. Запуск и конечные точки this
и указанная дата. Результат будет отрицателен, если конец будет перед запуском. Знак минус будет тем же самым в каждом годе, месяце и дне.
Вычисление выполняется, используя хронологию этой даты. В случае необходимости входная дата будет преобразована в соответствие.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе ChronoLocalDate<JapaneseDate>
endDate
- дата окончания, монопольная, который может быть в любой хронологии, не нулеpublic long toEpochDay()
ChronoLocalDate
Epoch Day count
простое количество постепенного увеличения дней, где день 0 01.01.1970 (ISO). Это определение является тем же самым для всех хронологий, включая преобразованию.
Эта реализация по умолчанию запрашивает EPOCH_DAY
поле.
toEpochDay
в интерфейсе ChronoLocalDate<JapaneseDate>
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<JapaneseDate>
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<JapaneseDate>
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public String toString()
Object
toString
метод возвращает строку, которая "дословно представляет" этот объект. Результатом должно быть краткое, но информативное представление, которое легко для человека читать. Рекомендуется, чтобы все подклассы переопределили этот метод. toString
метод для class Object
возвращает строку, состоящую из имени class, которого объект является экземпляром, символ знака at-sign`@
', и шестнадцатеричное представление без знака хэш-кода объекта. Другими словами этот метод возвращает строку, равную значению:
getClass().getName() + '@' + Integer.toHexString(hashCode())
toString
в интерфейсе ChronoLocalDate<JapaneseDate>
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
- если числовое переполнение происходит
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92