Интерфейс 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-секунд, которое представляет собой количество прошедших секунд с момента 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.

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