Spec-Zone .ru
спецификации, руководства, описания, API
|
D
- конкретный тип для даты этого разового датойpublic interface ChronoLocalDateTime<D extends ChronoLocalDate<D>> extends Temporal, TemporalAdjuster, Comparable<ChronoLocalDateTime<?>>
Большинство приложений должно объявить сигнатуры методов, поля и переменные как LocalDateTime
, не этот интерфейс.
A ChronoLocalDateTime
абстрактное представление локальной переменной, разовой датой где Chronology chronology
, или календарная система, является сменным. Разовое датой определяется с точки зрения полей, выраженных TemporalField
, где наиболее распространенные реализации определяются в ChronoField
. Хронология определяет, как календарная система работает и значение стандартных полей.
LocalDateTime
вместо этого интерфейса, даже в случае, где приложение должно иметь дело с многократными календарными системами. Объяснение для этого исследуется подробно в ChronoLocalDate
. Гарантируйте что обсуждение в ChronoLocalDate
был считан и понят перед использованием этого интерфейса.
Модификатор и Тип | Метод и Описание |
---|---|
default Temporal |
adjustInto(Temporal temporal)
Корректирует указанный временный объект иметь ту же самую дату и время как этот объект.
|
ChronoZonedDateTime<D> |
atZone(ZoneId zone)
Объединяется на сей раз с часовым поясом, чтобы создать a
ChronoZonedDateTime . |
default int |
compareTo(ChronoLocalDateTime<?> other)
Сравнивает это разовое датой с другим разовым датой, включая хронологию.
|
boolean |
equals(Object obj)
Проверки, если это разовое датой равно другому разовому датой, включая хронологию.
|
default String |
format(DateTimeFormatter formatter)
Форматы это разовое датой использование указанного средства форматирования.
|
static ChronoLocalDateTime<?> |
from(TemporalAccessor temporal)
Получает экземпляр
ChronoLocalDateTime от временного объекта. |
int |
hashCode()
Хэш-код для этого разового датой.
|
default boolean |
isAfter(ChronoLocalDateTime<?> other)
Проверки, если это разовое датой после указанного разового датой игнорирования хронологии.
|
default boolean |
isBefore(ChronoLocalDateTime<?> other)
Проверки, если это разовое датой перед указанным разовым датой игнорированием хронологии.
|
default boolean |
isEqual(ChronoLocalDateTime<?> other)
Проверки, если это разовое датой равно указанному разовому датой игнорированию хронологии.
|
boolean |
isSupported(TemporalField field)
Проверки, если указанное поле поддерживается.
|
default ChronoLocalDateTime<D> |
minus(long amountToSubtract, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с вычтенным установленным периодом.
|
default ChronoLocalDateTime<D> |
minus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с вычтенным количеством.
|
ChronoLocalDateTime<D> |
plus(long amountToAdd, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с добавленным установленным периодом.
|
default ChronoLocalDateTime<D> |
plus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с добавленным количеством.
|
default <R> R |
query(TemporalQuery<R> query)
Запросы это разовое датой использование указанного запроса.
|
static Comparator<ChronoLocalDateTime<?>> |
timeLineOrder()
Получает компаратор, который сравнивается
ChronoLocalDateTime в порядке временной шкалы, игнорирующем хронологию. |
default long |
toEpochSecond(ZoneOffset offset)
Преобразовывает это разовое датой в число секунд от эпохи 1970-01-01T00:00:00Z.
|
default Instant |
toInstant(ZoneOffset offset)
Преобразовывает это разовое датой в
Instant . |
D |
toLocalDate()
Получает локальную часть даты этого разового датой.
|
LocalTime |
toLocalTime()
Получает часть местного времени этого разового датой.
|
Строка |
toString()
Выводит это разовое датой как a
String . |
default ChronoLocalDateTime<D> |
with(TemporalAdjuster adjuster)
Возвращает скорректированный объект того же самого типа как этот объект с внесенной корректировкой.
|
ChronoLocalDateTime<D> |
with(TemporalField field, long newValue)
Возвращает объект того же самого типа как этот объект с указанным измененным полем.
|
periodUntil
get, getLong, range
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
static Comparator<ChronoLocalDateTime<?>> timeLineOrder()
ChronoLocalDateTime
в порядке временной шкалы, игнорирующем хронологию. Этот компаратор отличается от сравнения в compareTo(java.time.chrono.ChronoLocalDateTime<?>)
в этом это только сравнивает базовое разовое датой а не хронологию. Это позволяет датам в различных календарных системах быть сравненными основанные на позиции разового датой на локальной временной шкале. Базовое сравнение эквивалентно сравнению дневного эпохой и nano-of-day.
isAfter(java.time.chrono.ChronoLocalDateTime<?>)
, isBefore(java.time.chrono.ChronoLocalDateTime<?>)
, isEqual(java.time.chrono.ChronoLocalDateTime<?>)
static ChronoLocalDateTime<?> from(TemporalAccessor temporal)
ChronoLocalDateTime
от временного объекта. Это получает локальную переменную, разовую датой основанный на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр ChronoLocalDateTime
.
Преобразование извлекает и комбинирует хронологию и разовое датой от временного объекта. Поведение эквивалентно использованию Chronology.localDateTime(TemporalAccessor)
с извлеченной хронологией. Реализациям разрешают выполнить оптимизацию, такую как доступ к тем полям, которые эквивалентны соответствующим объектам.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, ChronoLocalDateTime::from
.
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a ChronoLocalDateTime
Chronology.localDateTime(TemporalAccessor)
D toLocalDate()
Это возвращает локальную дату с тем же самым годом, месяцем и днем как это разовое датой.
LocalTime toLocalTime()
Это возвращает местное время с тем же самым часом, минутой, второй и наносекунда как это разовое датой.
boolean isSupported(TemporalField field)
TemporalAccessor
Это проверяет, может ли разовое датой быть запрошено для указанного поля. Если ложь, то вызов range
и get
методы выдадут исключение.
isSupported
в интерфейсе TemporalAccessor
field
- поле, чтобы проверить, обнулите, возвращает falsedefault ChronoLocalDateTime<D> 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
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитChronoLocalDateTime<D> with(TemporalField field, long newValue)
Это возвращает новое основанное на объектах на этом со значением для указанного измененного поля. Например, на a LocalDate
, это могло использоваться, чтобы установить год, месяц или день-месячного. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если целевой объект является датой, представляющей 31-ого января, то изменение месяца до февраля было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеDateTimeException
- если поле не может быть установленоArithmeticException
- если числовое переполнение происходитdefault ChronoLocalDateTime<D> 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
в интерфейсе Temporal
amount
- количество, чтобы добавить, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитChronoLocalDateTime<D> plus(long amountToAdd, TemporalUnit unit)
Этот метод возвращает новое основанное на объектах на этом с добавленным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы добавить много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого января, то добавление одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
plus
в интерфейсе Temporal
amountToAdd
- количество указанного модуля, чтобы добавить, может быть отрицательнымunit
- модуль периода, чтобы добавить, не нульDateTimeException
- если модуль не может быть добавленArithmeticException
- если числовое переполнение происходитdefault ChronoLocalDateTime<D> 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
в интерфейсе Temporal
amount
- количество, чтобы вычесть, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитdefault ChronoLocalDateTime<D> minus(long amountToSubtract, TemporalUnit unit)
Этот метод возвращает новое основанное на объектах на этом с вычтенным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы вычесть много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого марта, то вычитание одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
minus
в интерфейсе Temporal
amountToSubtract
- количество указанного модуля, чтобы вычесть, может быть отрицательнымunit
- модуль периода, чтобы вычесть, не нульDateTimeException
- если модуль не может быть вычтенArithmeticException
- если числовое переполнение происходитdefault <R> R query(TemporalQuery<R> query)
Это запрашивает это разовое датой использование указанного объекта стратегии запроса. TemporalQuery
объект определяет логику, которая будет использоваться, чтобы получить результат. Считайте документацию запроса, чтобы понять, каков результат этого метода будет.
Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor)
метод на указанной передаче запроса this
как параметр.
query
в интерфейсе TemporalAccessor
R
- тип результатаquery
- запрос, чтобы вызвать, не нульDateTimeException
- если неспособный запрашивать (определенный запросом)ArithmeticException
- если числовое переполнение происходит (определенный запросом)default Temporal adjustInto(Temporal temporal)
Это возвращает временный объект того же самого заметного типа как ввод с датой и время, измененное, чтобы быть тем же самым как этим.
Корректировка эквивалентна использованию Temporal.with(TemporalField, long)
дважды, передача ChronoField.EPOCH_DAY
и ChronoField.NANO_OF_DAY
как поля.
В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisLocalDateTime.adjustInto(temporal); temporal = temporal.with(thisLocalDateTime);
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
adjustInto
в интерфейсе TemporalAdjuster
temporal
- целевой объект, который будет скорректирован, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитdefault String format(DateTimeFormatter formatter)
Это разовое датой передадут к средству форматирования, чтобы произвести строку.
Реализация по умолчанию должна вести себя следующим образом:
return formatter.format(this);
formatter
- средство форматирования, чтобы использовать, не нульDateTimeException
- если ошибка происходит во время печатиChronoZonedDateTime<D> atZone(ZoneId zone)
ChronoZonedDateTime
. Это возвращает a ChronoZonedDateTime
сформированный из этого разового датой в указанном часовом поясе. Результат будет соответствовать это разовое датой настолько близко насколько возможно. Правила часового пояса, такие как переход на летнее время, означают, что не каждая разовая датой локальная переменная допустима для указанной зоны, таким образом разовая датой локальная переменная может быть скорректирована.
Разовая датой локальная переменная разрешается к единственному моменту на временной шкале. Это достигается, находя допустимое смещение от UTC/Гринвича для локальной переменной, разовой датой как определено rules
из зонального ID.
В большинстве случаев есть только одно допустимое смещение для разовой датой локальной переменной. В случае перекрытия, где часы задерживаются, есть два допустимых смещения. Этот метод использует ранее смещение, обычно соответствующее "лету".
В случае разрыва, где часы переходят вперед, нет никакого допустимого смещения. Вместо этого разовая датой локальная переменная корректируется, чтобы быть позже длиной разрыва. Для изменения перехода на летнее время типичного одного часа разовая датой локальная переменная будет перемещена один час спустя в смещение, обычно соответствующее "лету".
Чтобы получить более позднее смещение во время перекрытия, вызвать ChronoZonedDateTime.withLaterOffsetAtOverlap()
на результате этого метода.
zone
- часовой пояс, чтобы использовать, не нульdefault Instant toInstant(ZoneOffset offset)
Instant
. Это комбинирует эту разовую датой локальную переменную и указанное смещение, чтобы сформироваться Instant
.
Эта реализация по умолчанию вычисляет с дневной эпохой из даты и второго-дневного из времени.
offset
- смещение, чтобы использовать для преобразования, не нуляInstant
представление того же самого момента, не нуляdefault long toEpochSecond(ZoneOffset offset)
Это комбинирует эту разовую датой локальную переменную и указанное смещение, чтобы вычислить значение с секундой эпохи, которое является числом прошедших секунд от 1970-01-01T00:00:00Z. Моменты на временной шкале после эпохи положительны, ранее отрицательны.
Эта реализация по умолчанию вычисляет с дневной эпохой из даты и второго-дневного из времени.
offset
- смещение, чтобы использовать для преобразования, не нуляdefault int compareTo(ChronoLocalDateTime<?> other)
Сравнение базируется сначала на базовой разовой датой временной шкале, затем на хронологии. Это является "непротиворечивым с, равняется", как определено Comparable
.
Например, следующее является порядком компаратора:
2012-12-03T12:00 (ISO)
2012-12-04T12:00 (ISO)
2555-12-04T12:00 (ThaiBuddhist)
2012-12-05T12:00 (ISO)
Если все разовые датой сравниваемые объекты находятся в той же самой хронологии, то дополнительный этап хронологии не требуется, и только разовая датой локальная переменная используется.
Эта реализация по умолчанию выполняет сравнение, определенное выше.
compareTo
в интерфейсе Comparable<ChronoLocalDateTime<?>>
other
- другое разовое датой, чтобы сравнить с, не нульdefault boolean isAfter(ChronoLocalDateTime<?> other)
Этот метод отличается от сравнения в compareTo(java.time.chrono.ChronoLocalDateTime<?>)
в этом это только сравнивает базовое разовое датой а не хронологию. Это позволяет датам в различных календарных системах быть сравненными основанные на позиции временной шкалы.
Эта реализация по умолчанию выполняет сравнение, основанное на дневном эпохой и nano-of-day.
other
- другое разовое датой, чтобы сравнить с, не нульdefault boolean isBefore(ChronoLocalDateTime<?> other)
Этот метод отличается от сравнения в compareTo(java.time.chrono.ChronoLocalDateTime<?>)
в этом это только сравнивает базовое разовое датой а не хронологию. Это позволяет датам в различных календарных системах быть сравненными основанные на позиции временной шкалы.
Эта реализация по умолчанию выполняет сравнение, основанное на дневном эпохой и nano-of-day.
other
- другое разовое датой, чтобы сравнить с, не нульdefault boolean isEqual(ChronoLocalDateTime<?> other)
Этот метод отличается от сравнения в compareTo(java.time.chrono.ChronoLocalDateTime<?>)
в этом это только сравнивает базовую дату и время а не хронология. Это позволяет временам даты в различных календарных системах быть сравненными основанные на позиции временной шкалы.
Эта реализация по умолчанию выполняет сравнение, основанное на дневном эпохой и nano-of-day.
other
- другое разовое датой, чтобы сравнить с, не нульboolean equals(Object obj)
Сравнивает это разовое датой с другим обеспечением, что разовым датой и хронологией является то же самое.
equals
в class Object
obj
- объект проверить, обнулите, возвращает falseObject.hashCode()
, HashMap
int hashCode()
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92