ITemporalUnit.AddTo(Object, Int64) 方法

定义

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

[Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", 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;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member 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);
              temporal = temporal.plus(thisUnit);

建议使用第二种方法, plus(TemporalUnit)因为在代码中读取内容要清晰得多。

实现应使用可用 ChronoUnit 单位或可用 ChronoField字段执行任何查询或计算。 如果不支持该单元, UnsupportedTemporalTypeException 则必须引发该单元。

实现不得更改指定的临时对象。 相反,必须返回原始副本的调整副本。 这为不可变和可变实现提供了等效的安全行为。

适用于 . 的 java.time.temporal.TemporalUnit.addTo(R, long)Java 文档

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

适用于