Интерфейс 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, то результат этого метода получается путем вызова TemporalField.isSupportedBy(TemporalAccessor) с передачей this в качестве аргумента. Поддерживается ли поле, определяется самим полем.

default boolean isSupported(TemporalUnit unit)

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

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

Набор поддерживаемых единиц измерения определяется хронологией и обычно включает все единицы измерения, кроме 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.

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