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

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

Этот компаратор отличается от сравнения в compareTo(java.time.chrono.ChronoZonedDateTime<?>) тем, что он сравнивает только базовый момент времени, а не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе позиции даты и времени на временной шкале момента. Базовое сравнение эквивалентно сравнению эпохи в секундах и наносекундах.

Получает экземпляр ChronoZonedDateTime из временного объекта.

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

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

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

Получает диапазон допустимых значений для указанного поля.

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

Обратите внимание, что результат описывает только минимальное и максимальное допустимые значения, и не стоит слишком многого от них ждать. Например, могут быть значения в диапазоне, которые недопустимы для поля.

Получает значение указанного поля как int.

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

Получает значение указанного поля как long.

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

Получает часть локальной даты этой даты и времени.

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

Получает часть локального времени этой даты и времени.

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

Получает часть локальной даты и времени этой даты и времени.

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

Получает хронологию этой даты и времени.

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

Получает смещение часового пояса, например, '+01:00'.

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

Получает идентификатор часового пояса, например, 'Europe/Paris'.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Преобразует эту дату и время в количество секунд с начала эпохи 1970-01-01T00:00:00Z.

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

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

Сравнение основано сначала на моменте времени, затем на местном времени, затем на идентификаторе зоны, затем на хронологии. Оно "совместимо с equals", как определено в Comparable.

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

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

Проверяет, является ли мгновение времени этой даты и времени раньше, чем мгновение времени указанной даты и времени.

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

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

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

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

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

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

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

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

Проверяет, равна ли эта дата и время другой дате и времени.

Сравнение основано на смещенной дате и времени и на зоне. Для сравнения одних и тех же моментов времени на временной шкале используйте compareTo(java.time.chrono.ChronoZonedDateTime<?>). Сравниваются только объекты типа ChronoZonedDateTime, другие типы возвращают false.

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

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