Класс ZonedDateTime

public static ZonedDateTime now()

Получает текущую дату и время от системных часов в часовом поясе по умолчанию.

Это обратится к system clock в часовом поясе по умолчанию, чтобы получить текущую дату и время. Зона и смещение будут установлены на основе часового пояса в часах.

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

public static ZonedDateTime now(ZoneId zone)

Получает текущую дату и время от системных часов в указанном часовом поясе.

Это обратится к system clock, чтобы получить текущую дату и время. Указание часового пояса позволяет избежать зависимости от часового пояса по умолчанию. Смещение будет рассчитано из указанного часового пояса.

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

public static ZonedDateTime now(Clock clock)

Получает текущую дату и время от указанных часов.

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

Использование этого метода позволяет использовать альтернативные часы для тестирования. Альтернативные часы могут быть введены с помощью dependency injection.

public static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)

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

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

Локальная дата и время сначала объединяются для формирования локальной даты и времени. Затем локальная дата и время преобразуются в единственный момент на временной шкале. Это достигается путем поиска допустимого смещения от UTC/Гринвича для локальной даты и времени, как определено в rules идентификатора зоны.

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

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

public static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)

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

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

Локальная дата и время преобразуются в единственный момент на временной шкале. Это достигается путем поиска допустимого смещения от UTC/Гринвича для локальной даты и времени, как определено в rules идентификатора зоны.

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

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

public static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)

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

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

Локальная дата и время преобразуются в единственный момент на временной шкале. Это достигается путем поиска допустимого смещения от UTC/Гринвича для локальной даты и времени, как определено в rules идентификатора зоны.

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

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

Этот метод существует в основном для написания тестовых случаев. Не тестовый код обычно использует другие методы для создания смещенного времени. LocalDateTime имеет пять дополнительных удобных вариантов эквивалентного метода фабрики, принимающего меньшее количество аргументов. Они не предоставляются здесь, чтобы уменьшить объем API.

public static ZonedDateTime ofLocal(LocalDateTime localDateTime, ZoneId zone, ZoneOffset preferredOffset)

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

Локальная дата и время преобразуются в единственный момент на временной шкале. Это достигается путем поиска допустимого смещения от UTC/Гринвича для локальной даты и времени, как определено в rules идентификатора зоны.

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

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

public static ZonedDateTime ofInstant(Instant instant, ZoneId zone)

Получает экземпляр ZonedDateTime из Instant.

Это создает зонированную дату и время с тем же моментом времени, что и указанный. Вызов ChronoZonedDateTime.toInstant() вернет момент времени, равный использованному здесь.

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

public static ZonedDateTime ofInstant(LocalDateTime localDateTime, ZoneOffset offset, ZoneId zone)

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

Это создает зонированную дату и время с помощью combining LocalDateTime и ZoneOffset. Эта комбинация однозначно определяет момент времени без неоднозначности.

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

Если ZoneId, который будет использоваться, является ZoneOffset, этот метод эквивалентен of(LocalDateTime, ZoneId).

public static ZonedDateTime ofStrict(LocalDateTime localDateTime, ZoneOffset offset, ZoneId zone)

Получает экземпляр ZonedDateTime с жёсткой проверкой комбинации локальной даты-времени, смещения и идентификатора зоны.

Это создаёт объект zoned date-time, гарантируя, что смещение является допустимым для локальной даты-времени согласно правилам указанной зоны. Если смещение недопустимо, выбрасывается исключение.

public static ZonedDateTime from(TemporalAccessor temporal)

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

Это получает объект zoned date-time на основе указанного временного объекта. Объект TemporalAccessor представляет собой произвольный набор информации о дате и времени, который эта фабрика преобразует в экземпляр ZonedDateTime.

Преобразование сначала получит ZoneId из временного объекта, перейдя к ZoneOffset при необходимости. Затем оно попытается получить Instant, перейдя к LocalDateTime при необходимости. Результатом будет либо комбинация ZoneId или ZoneOffset со Instant или LocalDateTime. Реализации разрешено выполнять оптимизации, такие как доступ к тем полям, которые эквивалентны соответствующим объектам.

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

public static ZonedDateTime parse(CharSequence text)

Получает экземпляр ZonedDateTime из текстовой строки, например, 2007-12-03T10:15:30+01:00[Europe/Paris].

Строка должна представлять собой допустимую дату-время и анализируется с помощью DateTimeFormatter.ISO_ZONED_DATE_TIME.

public static ZonedDateTime parse(CharSequence text, DateTimeFormatter formatter)

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

Текст анализируется с помощью форматера, возвращая дату-время.

public boolean isSupported(TemporalField field)

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

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

Если поле является ChronoField, то запрос реализуется здесь. Поддерживаемые поля:

• NANO_OF_SECOND
• NANO_OF_DAY
• MICRO_OF_SECOND
• MICRO_OF_DAY
• MILLI_OF_SECOND
• MILLI_OF_DAY
• SECOND_OF_MINUTE
• SECOND_OF_DAY
• MINUTE_OF_HOUR
• MINUTE_OF_DAY
• HOUR_OF_AMPM
• CLOCK_HOUR_OF_AMPM
• HOUR_OF_DAY
• CLOCK_HOUR_OF_DAY
• AMPM_OF_DAY
• DAY_OF_WEEK
• ALIGNED_DAY_OF_WEEK_IN_MONTH
• ALIGNED_DAY_OF_WEEK_IN_YEAR
• DAY_OF_MONTH
• DAY_OF_YEAR
• EPOCH_DAY
• ALIGNED_WEEK_OF_MONTH
• ALIGNED_WEEK_OF_YEAR
• MONTH_OF_YEAR
• PROLEPTIC_MONTH
• YEAR_OF_ERA
• YEAR
• ERA
• INSTANT_SECONDS
• OFFSET_SECONDS

Все остальные ChronoField объекты вернут false.

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

public boolean isSupported(TemporalUnit unit)

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

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

Если единица измерения является ChronoUnit, то запрос реализуется здесь. Поддерживаемые единицы измерения:

• NANOS
• MICROS
• MILLIS
• SECONDS
• MINUTES
• HOURS
• HALF_DAYS
• DAYS
• WEEKS
• MONTHS
• YEARS
• DECADES
• CENTURIES
• MILLENNIA
• ERAS

Все остальные ChronoUnit объекты вернут false.

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

public ValueRange range(TemporalField field)

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

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

Если поле является ChronoField, то запрос реализуется здесь. Метод supported fields вернёт соответствующие объекты диапазона. Все остальные ChronoField объекты выбросят исключение UnsupportedTemporalTypeException.

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

public int get(TemporalField field)

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

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

Если поле является ChronoField, то запрос реализуется здесь. supported fields вернет допустимые значения на основе этой даты и времени, за исключением NANO_OF_DAY, MICRO_OF_DAY, EPOCH_DAY, PROLEPTIC_MONTH и INSTANT_SECONDS, которые слишком велики, чтобы поместиться в int и вызывают UnsupportedTemporalTypeException. Все другие ChronoField экземпляры вызовут UnsupportedTemporalTypeException.

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

public long getLong(TemporalField field)

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

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

Если поле является ChronoField, то запрос реализуется здесь. supported fields вернет допустимые значения на основе этой даты и времени. Все другие ChronoField экземпляры вызовут UnsupportedTemporalTypeException.

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

public ZoneOffset getOffset()

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

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

public ZonedDateTime withEarlierOffsetAtOverlap()

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

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

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

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

public ZonedDateTime withLaterOffsetAtOverlap()

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

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

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

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

public ZoneId getZone()

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

Это возвращает идентификатор часового пояса. Он идентифицирует часовой пояс rules, определяющий, когда и как меняется смещение от UTC/Гринвича.

Идентификатор часового пояса может совпадать с смещением. Если это так, то все будущие вычисления, такие как сложение или вычитание, не имеют сложных граничных случаев из-за правил часового пояса. См. также withFixedOffsetZone().

public ZonedDateTime withZoneSameLocal(ZoneId zone)

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

Этот метод изменяет часовой пояс и сохраняет локальную дату и время. Локальная дата и время изменяются только в том случае, если они недопустимы для нового часового пояса, определяемого с помощью того же подхода, что и ofLocal(LocalDateTime, ZoneId, ZoneOffset).

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

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

public ZonedDateTime withZoneSameInstant(ZoneId zone)

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

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

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

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

public ZonedDateTime withFixedOffsetZone()

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

Это возвращает зонированную дату и время, где идентификатор часового пояса такой же, как getOffset(). Локальная дата, время, смещение и мгновение результата будут такими же, как в этой дате и времени.

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

Это эквивалентно ZonedDateTime.of(zdt.toLocalDateTime(), zdt.getOffset()).

public LocalDateTime toLocalDateTime()

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

Это возвращает LocalDateTime с тем же годом, месяцем, днем и временем, что и в этой дате и времени.

public LocalDate toLocalDate()

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

Это возвращает LocalDate с тем же годом, месяцем и днем, что и в этой дате и времени.

public int getYear()

Получает поле года.

Этот метод возвращает примитивное значение int для года.

Год, возвращаемый этим методом, является пролептическим, согласно get(YEAR). Чтобы получить год эпохи, используйте get(YEAR_OF_ERA).

public int getMonthValue()

Получает поле месяца от 1 до 12.

Этот метод возвращает месяц в виде int от 1 до 12. Код приложения часто становится более понятным, если использовать перечисление Month вызывая getMonth().

public Month getMonth()

Получает поле месяца с использованием перечисления Month.

Этот метод возвращает перечисление Month для месяца. Это позволяет избежать неоднозначности, что int значения означают. Если вам нужен доступ к примитивному значению int, то перечисление предоставляет int value.

public int getDayOfMonth()

Получает поле дня месяца.

Этот метод возвращает примитивное int значение для дня месяца.

public int getDayOfYear()

Получает поле дня года.

Этот метод возвращает примитивное int значение для дня года.

public DayOfWeek getDayOfWeek()

Получает поле дня недели, которое является перечислением DayOfWeek.

Этот метод возвращает перечисление DayOfWeek для дня недели. Это позволяет избежать неоднозначности, что int значения означают. Если вам нужен доступ к примитивному int значению, то перечисление предоставляет int value.

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

public LocalTime toLocalTime()

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

Этот метод возвращает LocalTime с тем же часом, минутой, секундой и наносекундой, что и этот объект даты и времени.

public int getHour()

Получает поле часа дня.

public int getMinute()

Получает поле минуты.

public int getSecond()

Получает поле секунды.

public int getNano()

Получает поле наносекунд.

public ZonedDateTime with(TemporalAdjuster adjuster)

Возвращает скопированную дату и время с произведённой корректировкой.

Этот метод возвращает скопированную копию объекта даты и времени, исходя из исходного, с произведённой корректировкой даты и времени. Корректировка происходит с помощью объекта стратегии корректировки. Прочитайте документацию корректировщика, чтобы понять, какая корректировка будет произведена.

Простой корректировщик может просто установить одно из полей, например, поле год. Более сложный корректировщик может установить дату на последнее число месяца. Выбор общих корректировок предоставляется в TemporalAdjusters. Они включают нахождение "последнего дня месяца" и "следующей среды". Основные классы даты и времени также реализуют интерфейс TemporalAdjuster, такие как Month и MonthDay. Корректировщик отвечает за обработку особых случаев, таких как различные длины месяцев и високосные годы.

Например, этот код возвращает дату на последнее число июля:

  import static java.time.Month.*;
  import static java.time.temporal.TemporalAdjusters.*;

  result = zonedDateTime.with(JULY).with(lastDayOfMonth());
 

Классы LocalDate и LocalTime реализуют TemporalAdjuster, поэтому этот метод может быть использован для изменения даты, времени или смещения:

  result = zonedDateTime.with(date);
  result = zonedDateTime.with(time);
 

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

Результат этого метода получается путем вызова метода TemporalAdjuster.adjustInto(Temporal) указанного корректировщика, передавая this в качестве аргумента.

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

public ZonedDateTime with(TemporalField field, long newValue)

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

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

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

Если поле является ChronoField, то корректировка выполняется здесь.

Поле INSTANT_SECONDS вернёт объект даты и времени с указанным мгновением. Часовой пояс и наносекунда останутся без изменений. Смещение результата будет получено из нового мгновения и исходного часового пояса. Если новое значение мгновения выходит за допустимый диапазон, то будет брошено исключение DateTimeException.

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

Другие supported fields будут вести себя так же, как соответствующий метод в LocalDateTime. Часовой пояс не участвует в вычислениях и не будет изменён. При преобразовании обратно в ZonedDateTime, если локальная дата и время находятся в перекрытии, то смещение сохранится, если возможно, иначе будет использоваться более раннее смещение. Если в перерыве, локальная дата и время будет скорректирована вперёд на длину перерыва.

Все остальные экземпляры ChronoField выбросят исключение UnsupportedTemporalTypeException.

Если поле не является ChronoField, то результат этого метода получается путем вызова TemporalField.adjustInto(Temporal, long) с this в качестве аргумента. В этом случае поле определяет, следует ли и как корректировать мгновение.

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

public ZonedDateTime withYear(int year)

Возвращает копию этого ZonedDateTime с изменённым годом.

Операция выполняется на локальной временной шкале, changing the year локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime withMonth(int month)

Возвращает копию этого ZonedDateTime с изменённым месяцем года.

Операция выполняется на локальной временной шкале, changing the month локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime withDayOfMonth(int dayOfMonth)

Возвращает копию этого ZonedDateTime с изменённым днём месяца.

Операция выполняется на локальной временной шкале, changing the day-of-month локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime withDayOfYear(int dayOfYear)

Возвращает копию этого ZonedDateTime с изменённым днём года.

Операция выполняется на локальной временной шкале, changing the day-of-year локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime withHour(int hour)

Возвращает копию этого ZonedDateTime с изменённым часом дня.

Операция выполняется на локальной временной шкале, изменение времени локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime withMinute(int minute)

Возвращает копию этого ZonedDateTime с изменённой минутой часа.

Операция выполняется на локальной временной шкале, изменение времени локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime withSecond(int second)

Возвращает копию этого ZonedDateTime с изменённой секундой минуты.

Операция выполняется на локальной временной шкале, изменение времени локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime withNano(int nanoOfSecond)

Возвращает копию этого ZonedDateTime с изменёнными наносекундами секунды.

Операция выполняется на локальной временной шкале, изменение времени локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime truncatedTo(TemporalUnit unit)

Возвращает копию этого ZonedDateTime с усечённым временем.

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

Элемент должен иметь длительность, которая делится на длину стандартного дня без остатка. Это включает все предоставленные единицы времени в ChronoUnit и DAYS. Другие единицы вызывают исключение.

Операция выполняется на локальной временной шкале, truncating базового локального времени. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальное время находится в перекрытии, то смещение будет сохранено, если это возможно, иначе будет использовано более раннее смещение. Если в разрыве, локальное время будет смещено вперёд на длину разрыва.

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

public ZonedDateTime plus(TemporalAmount amountToAdd)

Возвращает копию этого объекта DateTime, к которому добавлено указанное количество.

Это возвращает новый объект ZonedDateTime, основанный на этом, с добавлением указанного количества. Это количество обычно является Period или Duration, но может быть любого другого типа, реализующего интерфейс TemporalAmount.

Вычисление делегируется объекту количества, вызывая TemporalAmount.addTo(Temporal). Реализация количества свободна реализовать добавление любым способом, однако, обычно она вызывает plus(long, TemporalUnit). Обратитесь к документации реализации количества, чтобы определить, можно ли его успешно добавить.

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

public ZonedDateTime plus(long amountToAdd, TemporalUnit unit)

Возвращает копию этого объекта DateTime, к которому добавлено указанное количество.

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

Если поле является ChronoUnit, то добавление реализовано здесь. Зона не участвует в расчёте и останется неизменной в результате. Вычисление для единиц измерения даты и времени отличается.

Единицы измерения даты работают с локальным временным отрезком. Сначала период добавляется к локальному объекту DateTime, затем он преобразуется обратно в объект ZonedDateTime, используя идентификатор зоны. Преобразование использует ofLocal(LocalDateTime, ZoneId, ZoneOffset) с смещением перед добавлением.

Единицы измерения времени работают с временным отрезком момента. Сначала период добавляется к локальному объекту DateTime, затем он преобразуется обратно в объект ZonedDateTime, используя идентификатор зоны. Преобразование использует ofInstant(LocalDateTime, ZoneOffset, ZoneId) со смещением перед добавлением.

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

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

public ZonedDateTime plusYears(long years)

Возвращает копию этого объекта ZonedDateTime с добавлением указанного количества лет.

Это действует на локальной временной шкале, adding years к локальному объекту DateTime. Это затем преобразуется обратно в объект ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальный объект DateTime находится в перекрытии, то смещение будет сохранено, если возможно, в противном случае будет использовано более раннее смещение. Если в зазоре, локальный объект DateTime будет скорректирован вперёд на длину зазора.

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

public ZonedDateTime plusMonths(long months)

Возвращает копию этого объекта ZonedDateTime с добавлением указанного количества месяцев.

Это действует на локальной временной шкале, adding months к локальному объекту DateTime. Это затем преобразуется обратно в объект ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальный объект DateTime находится в перекрытии, то смещение будет сохранено, если возможно, в противном случае будет использовано более раннее смещение. Если в зазоре, локальный объект DateTime будет скорректирован вперёд на длину зазора.

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

public ZonedDateTime plusWeeks(long weeks)

Возвращает копию этого объекта ZonedDateTime с добавлением указанного количества недель.

Это действует на локальной временной шкале, adding weeks к локальному объекту DateTime. Это затем преобразуется обратно в объект ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальный объект DateTime находится в перекрытии, то смещение будет сохранено, если возможно, в противном случае будет использовано более раннее смещение. Если в зазоре, локальный объект DateTime будет скорректирован вперёд на длину зазора.

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

public ZonedDateTime plusDays(long days)

Возвращает копию этого объекта ZonedDateTime с добавлением указанного количества дней.

Это действует на локальной временной шкале, adding days к локальному объекту DateTime. Это затем преобразуется обратно в объект ZonedDateTime, используя идентификатор зоны для получения смещения.

При преобразовании обратно в ZonedDateTime, если локальный объект DateTime находится в перекрытии, то смещение будет сохранено, если возможно, в противном случае будет использовано более раннее смещение. Если в зазоре, локальный объект DateTime будет скорректирован вперёд на длину зазора.

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

public ZonedDateTime plusHours(long hours)

Возвращает копию этого объекта ZonedDateTime с добавлением указанного количества часов.

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

Например, рассмотрим часовой пояс, такой как 'Europe/Paris', где осеннее переключение DST означает, что локальные моменты времени от 02:00 до 02:59 встречаются дважды, переходя от смещения +02:00 летом к +01:00 зимой.

• Добавление одного часа к 01:30+02:00 даст 02:30+02:00 (оба в летнее время)
• Добавление одного часа к 02:30+02:00 даст 02:30+01:00 (переход от летнего к зимнему времени)
• Добавление одного часа к 02:30+01:00 даст 03:30+01:00 (оба в зимнее время)
• Добавление трёх часов к 01:30+02:00 даст 03:30+01:00 (переход от летнего к зимнему времени)

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

public ZonedDateTime plusMinutes(long minutes)

Возвращает копию этого объекта ZonedDateTime с добавлением указанного количества минут.

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

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

public ZonedDateTime plusSeconds(long seconds)

Возвращает копию этого ZonedDateTime с добавлением указанного количества секунд.

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

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

public ZonedDateTime plusNanos(long nanos)

Возвращает копию этого ZonedDateTime с добавлением указанного количества наносекунд.

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

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

public ZonedDateTime minus(TemporalAmount amountToSubtract)

Возвращает копию этого объекта DateTime с указанной величиной, вычтенной.

Это возвращает ZonedDateTime, на основе этого, с указанным количеством, вычтенным. Величина обычно является Period или Duration, но может быть любого другого типа, реализующего интерфейс TemporalAmount.

Вычисление делегируется объекту величины вызовом TemporalAmount.subtractFrom(Temporal). Реализация величины свободна реализовывать вычитание любым способом, однако она обычно обращается к minus(long, TemporalUnit). Обратитесь к документации реализации величины, чтобы определить, можно ли успешно вычесть ее.

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

public ZonedDateTime minus(long amountToSubtract, TemporalUnit unit)

Возвращает копию этого объекта DateTime с указанной величиной, вычтенной.

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

Вычисление для единиц даты и времени отличается.

Единицы дат работают на локальной временной шкале. Сначала из локального времени и даты вычитается период, затем он преобразуется обратно в дату-время с временной зоной, используя идентификатор временной зоны. Преобразование использует ofLocal(LocalDateTime, ZoneId, ZoneOffset) с офсетом до вычитания.

Единицы времени работают на временной шкале мгновения. Сначала из локального времени и даты вычитается период, затем он преобразуется обратно в дату-время с временной зоной, используя идентификатор временной зоны. Преобразование использует ofInstant(LocalDateTime, ZoneOffset, ZoneId) с офсетом до вычитания.

Этот метод эквивалентен plus(long, TemporalUnit) с отрицательным значением величины. См. этот метод для полного описания того, как работает добавление, и, следовательно, вычитание.

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

public ZonedDateTime minusYears(long years)

Возвращает копию этого ZonedDateTime с указанным количеством лет, вычтенным.

Эта операция выполняется на локальной временной шкале, subtracting years для локального времени и даты. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор временной зоны для получения офсета.

При преобразовании обратно в ZonedDateTime, если локальное время и дата находятся в перекрытии, то офсет сохраняется, если возможно, в противном случае используется более ранний офсет. Если в разрыве, локальное время и дата будут скорректированы вперед на длину разрыва.

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

public ZonedDateTime minusMonths(long months)

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

Эта операция выполняется на локальной временной шкале, subtracting months для локального времени и даты. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор временной зоны для получения офсета.

При преобразовании обратно в ZonedDateTime, если локальное время и дата находятся в перекрытии, то офсет сохраняется, если возможно, в противном случае используется более ранний офсет. Если в разрыве, локальное время и дата будут скорректированы вперед на длину разрыва.

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

public ZonedDateTime minusWeeks(long weeks)

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

Эта операция выполняется на локальной временной шкале, subtracting weeks для локального времени и даты. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор временной зоны для получения офсета.

При преобразовании обратно в ZonedDateTime, если локальное время и дата находятся в перекрытии, то офсет сохраняется, если возможно, в противном случае используется более ранний офсет. Если в разрыве, локальное время и дата будут скорректированы вперед на длину разрыва.

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

public ZonedDateTime minusDays(long days)

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

Эта операция выполняется на локальной временной шкале, subtracting days для локального времени и даты. Затем это преобразуется обратно в ZonedDateTime, используя идентификатор временной зоны для получения офсета.

При преобразовании обратно в ZonedDateTime, если локальное время и дата находятся в перекрытии, то офсет сохраняется, если возможно, в противном случае используется более ранний офсет. Если в разрыве, локальное время и дата будут скорректированы вперед на длину разрыва.

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

public ZonedDateTime minusHours(long hours)

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

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

Например, рассмотрим часовой пояс, такой как 'Europe/Paris', где переход на зимнее время DST означает, что локальные времена с 02:00 до 02:59 встречаются дважды, при переходе со смещения +02:00 летом к +01:00 зимой.

• Вычитание одного часа из 03:30+01:00 даст 02:30+01:00 (оба значения в зимнем времени)
• Вычитание одного часа из 02:30+01:00 даст 02:30+02:00 (переход от зимнего к летнему времени)
• Вычитание одного часа из 02:30+02:00 даст 01:30+02:00 (оба значения в летнем времени)
• Вычитание трёх часов из 03:30+01:00 даст 01:30+02:00 (переход от зимнего к летнему времени)

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

public ZonedDateTime minusMinutes(long minutes)

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

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

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

public ZonedDateTime minusSeconds(long seconds)

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

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

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

public ZonedDateTime minusNanos(long nanos)

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

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

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

public <R> R query(TemporalQuery<R> query)

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

Данный метод запрашивает это время и дату, используя указанный объект стратегии запроса. Объект TemporalQuery определяет логику, используемую для получения результата. Прочитайте документацию запроса, чтобы понять, каким будет результат этого метода.

Результат этого метода получается путем вызова метода TemporalQuery.queryFrom(TemporalAccessor) на указанном запросе, передавая this в качестве аргумента.

public long until(Temporal endExclusive, TemporalUnit unit)

Вычисляет время до другой даты и времени в терминах указанной единицы измерения.

Данный метод вычисляет интервал времени между двумя объектами ZonedDateTime в терминах одной TemporalUnit. Начальная и конечная точки — это this и указанное время и дата. Результат будет отрицательным, если конечная точка находится до начальной. Например, количество дней между двумя датами и временем можно вычислить, используя startDateTime.until(endDateTime, DAYS).

Temporal , переданный в этот метод, преобразуется в ZonedDateTime с помощью from(TemporalAccessor). Если часовой пояс отличается между двумя зонированными датами и временем, указанная конечная дата и время нормализуются таким образом, чтобы иметь тот же часовой пояс, что и эта дата и время.

Вычисление возвращает целое число, представляющее количество полных единиц между двумя датами и временем. Например, количество месяцев между 2012-06-15T00:00Z и 2012-08-14T23:59Z будет только один месяц, так как это на одну минуту меньше двух месяцев.

Есть два равнозначных способа использования этого метода. Первый — вызвать этот метод. Второй — использовать TemporalUnit.between(Temporal, Temporal):

   // these two lines are equivalent
   amount = start.until(end, MONTHS);
   amount = MONTHS.between(start, end);
 

Выбор должен быть сделан на основе того, что делает код более читабельным.

Вычисление реализовано в этом методе для ChronoUnit. Поддерживаются единицы NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS и HALF_DAYS, DAYS, WEEKS, MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA и ERAS. Другие значения ChronoUnit приведут к исключению.

Вычисление для единиц даты и времени отличается.

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

Единицы времени работают на временной шкале мгновенных моментов времени. Вычисление фактически преобразует оба зонированных времени и даты в моменты времени и затем вычисляет период между моментами времени. Например, период с полудня первого дня до полудня следующего дня в часах может быть 23, 24 или 25 часами (или другой величиной) в зависимости от того, был ли переход на летнее или зимнее время.

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

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

public String format(DateTimeFormatter formatter)

Форматирует это время и дату, используя указанный форматтер.

Это время и дата будут переданы формату, чтобы получить строку.

public OffsetDateTime toOffsetDateTime()

Преобразует это время и дату в OffsetDateTime.

Данный метод создаёт объект смещенного времени и даты, используя локальную дату и время, и смещение. Идентификатор часового пояса игнорируется.

public boolean equals(Object obj)

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

Сравнение основано на смещенном времени и дате и часовом поясе. Сравниваются только объекты типа ZonedDateTime, другие типы возвращают false.

public int hashCode()

Хеш-код для этой даты и времени.

public String toString()

Выводит это время и дату как String, например 2007-12-03T10:15:30+01:00[Europe/Paris].

Формат состоит из LocalDateTime, за которым следует ZoneOffset. Если ZoneId отличается от смещения, то выводится идентификатор. Вывод совместим с ISO-8601, если смещение и идентификатор совпадают, а секунды в смещении равны нулю.