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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Это корректирует этот объект Temporal, добавляя в соответствии с правилами указанного значения. Значение обычно является 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 января, то добавление одного месяца будет неясным. В таких случаях поле отвечает за разрешение результата. Как правило, оно выберет предыдущую допустимую дату, которая в этом примере будет последним допустимым днем февраля.

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

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