ChronoUnit.AddTo(Object, Int64) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回添加指定句点的指定临时对象的副本。
[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 属性许可证中所述的术语使用。