Интерфейс ChronoLocalDateTime<D extends ChronoLocalDate>

static Comparator<ChronoLocalDateTime<?>> timeLineOrder()

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

Этот компаратор отличается от сравнения в compareTo(java.time.chrono.ChronoLocalDateTime<?>) тем, что он сравнивает только базовую дату и время, а не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе положения даты и времени на локальной временной линии. Базовое сравнение эквивалентно сравнению эпохи дня и наносекунд дня.

static ChronoLocalDateTime<?> from(TemporalAccessor temporal)

Получает экземпляр ChronoLocalDateTime из временного объекта.

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

Преобразование извлекает и объединяет хронологию и дату-время из временного объекта. Поведение эквивалентно использованию Chronology.localDateTime(TemporalAccessor) с извлеченной хронологией. Реализации разрешено выполнять оптимизации, такие как доступ к тем полям, которые эквивалентны соответствующим объектам.

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

default Chronology getChronology()

Получает хронологию этой даты и времени.

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

D toLocalDate()

Получает локальную часть даты этого объекта даты и времени.

Возвращает локальную дату с тем же годом, месяцем и днем, что и у этой даты и времени.

LocalTime toLocalTime()

Получает локальную часть времени этого объекта даты и времени.

Возвращает локальное время с теми же часами, минутами, секундами и наносекундами, что и у этой даты и времени.

boolean isSupported(TemporalField field)

Проверяет, поддерживается ли указанное поле.

Проверяет, может ли быть запрошено указанное поле в этом объекте даты и времени. Если false, то вызов методов range, get и with(TemporalField, long) вызовет исключение.

Набор поддерживаемых полей определяется хронологией и обычно включает все ChronoField поля даты и времени.

Если поле не является ChronoField, то результат этого метода получается путем вызова TemporalField.isSupportedBy(TemporalAccessor) с this в качестве аргумента. Поддерживается ли поле, определяется полем.

default boolean isSupported(TemporalUnit unit)

Проверяет, поддерживается ли указанный интервал.

Проверяет, можно ли добавить или вычесть указанный интервал к этому объекту даты и времени. Если false, то вызов методов plus(long, TemporalUnit) и minus вызовет исключение.

Набор поддерживаемых интервалов определяется хронологией и обычно включает все ChronoUnit интервалы, кроме FOREVER.

Если интервал не является ChronoUnit, то результат этого метода получается путем вызова TemporalUnit.isSupportedBy(Temporal) с this в качестве аргумента. Поддерживается ли интервал, определяется интервалом.

default ChronoLocalDateTime<D> 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
 

ChronoLocalDateTime<D> with(TemporalField field, long newValue)

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

Возвращает новый объект, основанный на этом, с измененным значением для указанного поля. Например, в объекте LocalDate, это можно использовать для установки года, месяца или дня месяца. Возвращаемый объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля не полностью определено. Например, если целевой объект является датой, представляющей 31 января, то изменение месяца на февраль будет неясно. В таких случаях поле отвечает за разрешение результата. Обычно оно выбирает предыдущую допустимую дату, что в этом примере будет последним допустимым днем февраля.

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

ChronoLocalDateTime<D> plus(long amountToAdd, TemporalUnit unit)

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

Этот метод возвращает новый объект, основанный на этом объекте, с добавлением указанного периода. Например, для LocalDate, это можно использовать для добавления определенного количества лет, месяцев или дней. Возвращаемый объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля не полностью определено. Например, если целевой объект — дата, представляющая 31 января, то добавление одного месяца будет неясно. В таких случаях поле отвечает за решение результата. Обычно оно выбирает предыдущую допустимую дату, которая в этом примере будет последним допустимым днем февраля.

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

default ChronoLocalDateTime<D> minus(long amountToSubtract, TemporalUnit unit)

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

Этот метод возвращает новый объект, основанный на этом объекте, с вычитанием указанного периода. Например, для LocalDate, это можно использовать для вычитания определенного количества лет, месяцев или дней. Возвращаемый объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля не полностью определено. Например, если целевой объект — дата, представляющая 31 марта, то вычитание одного месяца будет неясно. В таких случаях поле отвечает за решение результата. Обычно оно выбирает предыдущую допустимую дату, которая в этом примере будет последним допустимым днем февраля.

default <R> R query(TemporalQuery<R> query)

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

Это запрашивает эту дату и время с использованием указанного объекта стратегии запроса. Объект TemporalQuery определяет логику, используемую для получения результата. Прочитайте документацию запроса, чтобы понять, каким будет результат этого метода.

Результат этого метода получается путем вызова метода TemporalQuery.queryFrom(TemporalAccessor) на указанном запросе, передавая this в качестве аргумента.

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);
 

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

default String format(DateTimeFormatter formatter)

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

Эта дата и время будут переданы форматеру для создания строки.

Реализация по умолчанию должна вести себя следующим образом:

  return formatter.format(this);
 

ChronoZonedDateTime<D> atZone(ZoneId zone)

Объединяет это время с часовым поясом, чтобы создать ChronoZonedDateTime.

Это возвращает ChronoZonedDateTime , образованную из этой даты и времени в указанном часовом поясе. Результат будет соответствовать этой дате и времени как можно точнее. Правила часового пояса, такие как летнее время, означают, что не каждая локальная дата и время действительны для указанного часового пояса, поэтому локальная дата и время могут быть скорректированы.

Локальная дата и время разрешаются до единственного момента на временной шкале. Это достигается путем поиска допустимого смещения от UTC/Гринвича для локальной даты и времени, как определено в rules идентификатора часового пояса.

В большинстве случаев существует только одно допустимое смещение для локальной даты и времени. В случае перекрытия, когда часы переводятся назад, существует два допустимых смещения. Этот метод использует более раннее смещение, обычно соответствующее «лету».

В случае разрыва, когда часы переводятся вперед, нет допустимого смещения. Вместо этого локальная дата и время корректируются, чтобы быть позже на длительность разрыва. Для типичного изменения летнего времени на один час локальная дата и время будут переведены на один час позже в смещение, обычно соответствующее «лету».

Чтобы получить более позднее смещение во время перекрытия, вызовите ChronoZonedDateTime.withLaterOffsetAtOverlap() на результате этого метода.

default Instant toInstant(ZoneOffset offset)

Преобразует эту дату и время в Instant.

Это объединяет это локальное время и указанное смещение, чтобы сформировать Instant.

Эта реализация по умолчанию выполняет расчет по эпохе-дню даты и секунде-дня времени.

default long toEpochSecond(ZoneOffset offset)

Преобразует эту дату и время в количество секунд от эпохи 1970-01-01T00:00:00Z.

Это объединяет эту локальную дату и время и указанное смещение для вычисления значения epoch-second, которое представляет собой количество прошедших секунд с 1970-01-01T00:00:00Z. Моменты на временной шкале после эпохи положительные, раньше — отрицательные.

Эта реализация по умолчанию выполняет расчет по эпохе-дню даты и секунде-дня времени.

default int compareTo(ChronoLocalDateTime<?> other)

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

Сравнение основано сначала на базовой дате и времени на временной шкале, а затем на хронологии. Оно "согласовано с equals", как определено в Comparable.

Например, следующий порядок сравнения:

1. 2012-12-03T12:00 (ISO)
2. 2012-12-04T12:00 (ISO)
3. 2555-12-04T12:00 (ThaiBuddhist)
4. 2012-12-05T12:00 (ISO)

Значения #2 и #3 представляют одну и ту же дату и время на временной шкале. Когда два значения представляют одну и ту же дату и время, идентификатор хронологии используется для их различения. Этот шаг необходим для того, чтобы порядок был "согласован с equals".

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

Эта реализация по умолчанию выполняет сравнение, определённое выше.

default boolean isAfter(ChronoLocalDateTime<?> other)

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

Этот метод отличается от сравнения в compareTo(java.time.chrono.ChronoLocalDateTime<?>) тем, что он сравнивает только базовую дату и время, а не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе их позиции на временной шкале.

Эта реализация по умолчанию выполняет сравнение на основе эпохи и наносекунд.

default boolean isBefore(ChronoLocalDateTime<?> other)

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

Этот метод отличается от сравнения в compareTo(java.time.chrono.ChronoLocalDateTime<?>) тем, что он сравнивает только базовую дату и время, а не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе их позиции на временной шкале.

Эта реализация по умолчанию выполняет сравнение на основе эпохи и наносекунд.

default boolean isEqual(ChronoLocalDateTime<?> other)

Проверяет, равна ли эта дата и время указанной дате и времени, игнорируя хронологию.

Этот метод отличается от сравнения в compareTo(java.time.chrono.ChronoLocalDateTime<?>) тем, что он сравнивает только базовую дату и время, а не хронологию. Это позволяет сравнивать даты и время в разных календарных системах на основе их позиции на временной шкале.

Эта реализация по умолчанию выполняет сравнение на основе эпохи и наносекунд.

boolean equals(Object obj)

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

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

int hashCode()

Хеш-код для этой даты и времени.

String toString()

Выводит эту дату и время в формате String.

Вывод будет включать полную локальную дату и время.