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

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