Интерфейс 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 в качестве аргумента. Поддержка поля определяется самим полем.

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

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

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

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

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

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

Эта реализация по умолчанию выполняет сравнение на основе epoch-second и nano-of-second.

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

Эта реализация по умолчанию выполняет сравнение на основе epoch-second и nano-of-second.

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

Эта реализация по умолчанию выполняет сравнение на основе epoch-second и nano-of-second.

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

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