Язык

OffsetDateTime.With Метод

Определение

Перегрузки

Имя. Описание
With(ITemporalAdjuster)

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

With(ITemporalField, Int64)

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

With(ITemporalAdjuster)

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

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

Параметры

adjuster
ITemporalAdjuster

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

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

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

Атрибуты

Комментарии

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

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

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

With(ITemporalField, Int64)

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

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/OffsetDateTime;", "", 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/OffsetDateTime;", "", 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

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

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

OffsetDateTime на основе этого с указанным набором полей, а не null

Реализации

Атрибуты

Комментарии

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

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

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