语言

ChronoField.AdjustInto(Object, Int64) 方法

定义

返回具有此字段集值的指定临时对象的副本。

[Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "", ApiSince=26)]
[Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })]
public Java.Lang.Object? AdjustInto(Java.Lang.Object? temporal, long newValue);
[<Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member AdjustInto : Java.Lang.Object * int64 -> Java.Lang.Object
override this.AdjustInto : Java.Lang.Object * int64 -> Java.Lang.Object

参数

temporal
Object

要调整的临时对象,而不是 null

newValue
Int64

字段的新值

返回

调整后的时态对象,而不是 null

实现

特性

注解

返回具有此字段集值的指定临时对象的副本。 这将基于具有此字段的值已更改的指定对象返回新的临时对象。 例如,在 LocalDate 上,这可用于设置年、月或月。 返回的对象具有与指定对象相同的可观察类型。 在某些情况下,更改字段未完全定义。 例如,如果目标对象是表示 1 月 31 日的日期,则将月份更改为 2 月将不清楚。 在这种情况下,实现负责解决结果。 通常,它将选择上一个有效日期,这将是此示例中 2 月的最后一个有效日期。 使用此方法有两种等效的方法。 第一种方法是直接调用此方法。 第二个是使用 Temporal.with(TemporalField,long):

// these two lines are equivalent, but the second approach is recommended
temporal = thisField.adjustInto(temporal, newValue);
temporal = temporal.with(thisField, newValue);

建议使用第二种方法(TemporalField),因为代码中读取内容要清晰得多。 实现应使用 ChronoField 中可用的字段执行任何查询或计算。 如果不支持该字段,则必须引发 UnsupportedTemporalTypeException。 实现不得更改指定的临时对象。 相反,必须返回原始副本的调整副本。 这为不可变和可变实现提供了等效的安全行为。

Java参考java.time.temporal.ChronoField.adjustInto。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于