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

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

Создает дату и время с часовым поясом на основе указанного временного объекта. TemporalAccessor представляет произвольный набор сведений о дате и времени, который эта фабрика преобразует в экземпляр ChronoZonedDateTime.

Преобразование извлекает из временного объекта хронологию, дату, время и часовой пояс и объединяет их. Поведение эквивалентно использованию Chronology.zonedDateTime(TemporalAccessor) с извлеченной хронологией. Реализациям разрешается выполнять оптимизации, например обращаться к полям, эквивалентным соответствующим объектам.

Сигнатура этого метода соответствует функциональному интерфейсу TemporalQuery, поэтому его можно использовать в качестве запроса посредством ссылки на метод: ChronoZonedDateTime::from.

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

Возвращает локальную дату с теми же годом, месяцем и днем, что и у этого объекта даты и времени.

Возвращает локальное время с теми же часом, минутой, секундой и наносекундой, что и у этого объекта даты и времени.

Возвращает локальную дату с теми же годом, месяцем и днем, что и у этого объекта даты и времени.

Chronology представляет используемую календарную систему. Эра и другие поля в ChronoField определяются хронологией.

Это смещение локальной даты и времени относительно UTC/Гринвича.

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

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

Если вызвать этот метод, когда перекрытия нет, будет возвращено this.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

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

Если вызвать этот метод, когда перекрытия нет, будет возвращено this.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Этот метод меняет часовой пояс и сохраняет локальные дату и время. Локальные дата и время меняются только в том случае, если они недопустимы для нового часового пояса.

Чтобы изменить часовой пояс и скорректировать локальные дату и время, используйте withZoneSameInstant(ZoneId).

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Этот метод меняет часовой пояс и сохраняет момент времени. Обычно это приводит к изменению локальных даты и времени.

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

Чтобы изменить смещение, сохранив локальное время, используйте withZoneSameLocal(ZoneId).

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

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

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

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

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

Если единица измерения не является ChronoUnit, результат этого метода получается вызовом TemporalUnit.isSupportedBy(Temporal) с передачей this в качестве аргумента. Поддержку единицы измерения определяет сама единица.

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

Возвращает новый объект на основе этого, в котором изменено значение указанного поля. Например, для LocalDate это можно использовать, чтобы задать год, месяц или день месяца. Возвращенный объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля определено не полностью. Например, если целевой объект — дата, соответствующая 31 января, то неясно, как изменить месяц на февраль. В таких случаях поле отвечает за определение результата. Обычно выбирается предыдущая допустимая дата, то есть в данном примере последний допустимый день февраля.

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

Этот метод возвращает новый объект на основе этого, к которому прибавлен указанный период. Например, для LocalDate его можно использовать, чтобы прибавить несколько лет, месяцев или дней. Возвращенный объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля определено не полностью. Например, если целевой объект — дата, соответствующая 31 января, то неясно, как прибавить один месяц. В таких случаях поле отвечает за определение результата. Обычно выбирается предыдущая допустимая дата, то есть в данном примере последний допустимый день февраля.

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

Этот метод возвращает новый объект на основе этого, из которого вычтен указанный период. Например, для LocalDate его можно использовать, чтобы вычесть несколько лет, месяцев или дней. Возвращенный объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля определено не полностью. Например, если целевой объект — дата, соответствующая 31 марта, то неясно, как вычесть один месяц. В таких случаях поле отвечает за определение результата. Обычно выбирается предыдущая допустимая дата, то есть в данном примере последний допустимый день февраля.

Этот метод запрашивает сведения об этой дате и времени, используя указанный объект стратегии запроса. Объект TemporalQuery определяет логику получения результата. Чтобы понять, каким будет результат этого метода, ознакомьтесь с документацией запроса.

Результат этого метода получается вызовом метода TemporalQuery.queryFrom(TemporalAccessor) для указанного запроса с передачей this в качестве аргумента.

Эта дата и время будут переданы форматировщику для создания строки.

Реализация по умолчанию должна вести себя следующим образом:

 return formatter.format(this);

Возвращает Instant, представляющий ту же точку на временной шкале, что и эта дата и время. Для вычисления объединяются локальные дата и время и смещение.

Для вычисления количества секунд от начала эпохи 1970-01-01T00:00:00Z используются локальные дата и время и смещение. Моменты времени после начала эпохи положительны, а более ранние — отрицательны.

Сначала сравниваются моменты времени, затем локальные дата и время, потом идентификаторы часовых поясов и, наконец, хронологии. Сравнение «согласовано с equals» в соответствии с определением Comparable.

Если все сравниваемые объекты даты и времени принадлежат одной хронологии, дополнительный этап сравнения хронологий не требуется.

Эта реализация по умолчанию выполняет описанное выше сравнение.

Этот метод отличается от сравнения в compareTo(ChronoZonedDateTime) тем, что сравнивает только моменты времени. Это эквивалентно использованию dateTime1.toInstant().isBefore(dateTime2.toInstant());.

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

Этот метод отличается от сравнения в compareTo(ChronoZonedDateTime) тем, что сравнивает только моменты времени. Это эквивалентно использованию dateTime1.toInstant().isAfter(dateTime2.toInstant());.

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

Этот метод отличается от сравнения в compareTo(ChronoZonedDateTime) и equals(Object) тем, что сравнивает только моменты времени. Это эквивалентно использованию dateTime1.toInstant().equals(dateTime2.toInstant());.

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

Сравнение выполняется на основе даты и времени со смещением и часового пояса. Чтобы сравнить совпадение момента времени на временной шкале, используйте compareTo(ChronoZonedDateTime). Сравниваются только объекты типа ChronoZonedDateTime, для объектов других типов возвращается false.

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