语言

ChronoUnit.AddTo(Object, Int64) 方法

定义

返回添加指定句点的指定临时对象的副本。

[Android.Runtime.Register("addTo", "(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? AddTo(Java.Lang.Object? temporal, long amount);
[<Android.Runtime.Register("addTo", "(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 AddTo : Java.Lang.Object * int64 -> Java.Lang.Object
override this.AddTo : Java.Lang.Object * int64 -> Java.Lang.Object

参数

temporal
Object

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

amount
Int64

要添加的此单位的数量、正数或负数

返回

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

实现

特性

注解

返回添加指定句点的指定临时对象的副本。 添加的时间段是此单元的倍数。 例如,此方法可用于通过在表示“days”的实例上调用此方法(传递日期和句点“3”)将“3 天”添加到日期。 要添加的句点可能是负数,相当于减法。 使用此方法有两种等效的方法。 第一种方法是直接调用此方法。 第二种是使用 Temporal.plus(long,TemporalUnit):

// these two lines are equivalent, but the second approach is recommended
temporal = thisUnit.addTo(temporal, amount);
temporal = temporal.plus(amount, thisUnit);

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

Java参考java.time.temporal.ChronoUnit.addTo。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于