Язык

ZonedDateTime.With Метод

Определение

Перегрузки

Имя. Описание
With(ITemporalField, Int64)

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

With(ITemporalAdjuster)

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

With(ITemporalField, Int64)

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

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? With(Java.Time.Temporal.ITemporalField? field, long newValue);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
abstract member With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
override this.With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal

Параметры

field
ITemporalField

поле, заданное в результатах, а не null

newValue
Int64

новое значение поля в результате

Возвращаемое значение

ZonedDateTime на основе этого с заданным набором полей, а не null

Атрибуты

Комментарии

Возвращает копию этого даты и времени с указанным полем, заданным для нового значения. Возвращает zonedDateTime, основанное на этом, со значением для указанного поля. Это можно использовать для изменения любого поддерживаемого поля, например года, месяца или дня месяца. Если невозможно задать значение, так как поле не поддерживается или по какой-либо другой причине, возникает исключение. В некоторых случаях изменение указанного поля может привести к тому, что результирующее время даты станет недействительным, например изменение месяца с 31 января по февраль сделает день месяца недействительным. В таких случаях поле отвечает за разрешение даты. Обычно он выбирает предыдущую действительную дату, которая будет последним действительным днем февраля в этом примере. Если поле является хроноФилдом, то здесь реализована корректировка. Поле INSTANT_SECONDS возвращает дату и время с указанным моментом. Зона и нано-секунда не изменяются. Результат будет иметь смещение, полученное из новой мгновенной и исходной зоны. Если новое мгновенное значение находится за пределами допустимого диапазона, будет возникать исключение DateTimeException. Поле OFFSET_SECONDS обычно игнорируется. Смещение ZonedDateTime управляется главным образом часовыми поясами. Таким образом, изменение смещения обычно не имеет смысла, так как существует только одно допустимое смещение для локальной даты и зоны. Если зонированное время находится в перекрытии дневного времени, смещение используется для переключения между двумя допустимыми смещениями. Во всех остальных случаях смещение игнорируется. Если новое значение смещения находится за пределами допустимого диапазона, будет создано исключение DateTimeException. Другие поддерживаемые поля будут вести себя в соответствии с методом сопоставления в LocalDateTime. Зона не является частью вычисления и будет неизменной. При преобразовании обратно в ZonedDateTime, если локальное время даты находится в перекрытии, смещение будет сохранено, если это возможно, в противном случае будет использоваться более раннее смещение. Если в разрыве, локальное время даты будет скорректировано вперед по длине разрыва. Все остальные экземпляры ChronoField будут вызывать unsupportedTemporalTypeException. Если поле не является хронофилдом, результат этого метода получается путем вызова Темпорфилд.adjustInto(Темпоральный, длинный) передается в качестве аргумента. В этом случае поле определяет, следует ли и как изменить момент. Этот экземпляр неизменяем и не влияет на этот вызов метода.

Java справочные материалы.java.time.ZonedDateTime.with

Применяется к

With(ITemporalAdjuster)

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

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.ZonedDateTime? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.ZonedDateTime

Параметры

adjuster
ITemporalAdjuster

средство настройки, используемое, а не null

Возвращаемое значение

ZonedDateTime на основе этого с внесенной корректировкой, а не null

Атрибуты

Комментарии

Возвращает скорректированную копию этой даты и времени. При этом возвращается zonedDateTime, основанный на этом, с настроенным временем даты. Корректировка выполняется с помощью указанного объекта стратегии настройки. Ознакомьтесь с документацией по адаптировщику, чтобы понять, какие изменения будут сделаны. Простой корректирующий средство может просто задать одно из полей, таких как поле года. Более сложный адаптировщик может задать дату последнего дня месяца. В ТемпорАдюстерах предоставляется выбор общих параметров. К ним относятся поиск "последний день месяца" и "в следующую среду". Ключевые классы даты и времени также реализуют интерфейс TimeAdjuster, например Month и MonthDay. Адаптировщик отвечает за обработку особых случаев, таких как различные продолжительности месяца и високосных лет. Например, этот код возвращает дату в последний день июля: классы LocalDate и LocalTime реализуют TimeAdjuster, поэтому этот метод можно использовать для изменения даты, времени или смещения: ZoneOffset также реализует ТемпорАдюстер, однако использование его в качестве аргумента обычно не имеет никакого эффекта. Смещение ZonedDateTime управляется главным образом часовыми поясами. Таким образом, изменение смещения обычно не имеет смысла, так как существует только одно допустимое смещение для локальной даты и зоны. Если зонированное время находится в перекрытии дневного времени, смещение используется для переключения между двумя допустимыми смещениями. Во всех остальных случаях смещение игнорируется. Результат этого метода получен путем вызова метода TemporalAdjuster.adjustInto(Темпоральный) для указанного средства настройки, передавающего этот аргумент в качестве аргумента. Этот экземпляр неизменяем и не влияет на этот вызов метода.

Java справочные материалы.java.time.ZonedDateTime.with

Применяется к