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

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