OffsetDateTime.With 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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，并调整日期时间。 调整是使用指定的调整器策略对象进行的。 阅读调整器的文档，了解将进行哪些调整。 简单的调整器可能只是设置其中一个字段，例如年份字段。 更复杂的调整器可能会将日期设置为月份的最后一天。 在 TemporalAdjusters 中提供了一系列常见调整。 其中包括查找“本月的最后一天”和“下周三”。 关键日期时间类还实现 TemporalAdjuster 接口，例如 Month 和 MonthDay。 调整器负责处理特殊情况，例如月和跃年的不同长度。 例如，此代码返回 7 月最后一天的日期：类 LocalDate、LocalTime 和 ZoneOffset 实现 TemporalAdjuster，因此此方法可用于更改日期、时间或偏移量：此方法的结果是通过调用指定调整器上的 TemporalAdjuster.adjustInto（Temporal） 方法获取的，该方法作为参数传递。 此实例不可变，不受此方法调用影响。
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，并更改了指定字段的值。 这可用于更改任何受支持的字段，例如年、月或月。 如果无法设置值，因为该字段不受支持或出于其他原因，则会引发异常。 在某些情况下，更改指定的字段可能会导致生成的日期时间变得无效，例如将月份从 1 月 31 日更改为 2 月会使日期无效。 在这种情况下，字段负责解决日期。 通常，它将选择上一个有效日期，这将是此示例中 2 月的最后一个有效日期。 如果该字段是 ChronoField，则在此处实现调整。 INSTANT_SECONDS字段将返回具有指定即时的日期时间。 偏移量和纳秒不变。 如果新的即时值超出有效范围，则将引发 DateTimeException。 OFFSET_SECONDS字段将返回具有指定偏移量的日期时间。 本地日期时间不变。 如果新的偏移值超出有效范围，则将引发 DateTimeException。 其他支持的字段将按照 LocalDateTime 上的匹配方法运行。 在这种情况下，偏移量不是计算的一部分，不会更改。 所有其他 ChronoField 实例都将引发 UnsupportedTemporalTypeException。 如果字段不是 ChronoField，则通过调用 TemporalField.adjustInto（Temporal， long）作为参数来获取此方法的结果。 在这种情况下，字段确定是否以及如何调整即时。 此实例不可变，不受此方法调用影响。
Java参考java.time.OffsetDateTime.with。