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

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

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

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

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

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

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

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

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

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

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

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

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

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