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

static Comparator<ChronoLocalDateTime<?>> timeLineOrder()

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

Этот компаратор отличается от сравнения в compareTo(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, сформированные из этих даты и времени в указанном часовом поясе. Результат будет максимально точно соответствовать этим дате и времени. Правила часового пояса, например переход на летнее время, означают, что не всякие локальные дата и время допустимы в указанном часовом поясе, поэтому локальные дата и время могут быть скорректированы.

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

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

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

Чтобы получить более позднее смещение при перекрытии, вызовите 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(ChronoLocalDateTime) тем, что сравнивает только базовые дату и время, но не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе положения на временной шкале.

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

default boolean isBefore(ChronoLocalDateTime<?> other)

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

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

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

default boolean isEqual(ChronoLocalDateTime<?> other)

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

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

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

boolean equals(Object obj)

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

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

int hashCode()

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

String toString()

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

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