Интерфейс 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)

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

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

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

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

default boolean isSupported(TemporalUnit unit)

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

Это проверяет, можно ли добавить или вычесть указанный интервал из этой даты и времени. Если ложь, то вызов методов 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.

Это объединяет эту локальную дату и время с указанным смещением для расчёта значения эпохи в секундах, что является количеством прошедших секунд с 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.

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