Period.AddTo(ITemporal) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将此句点添加到指定的临时对象。
[Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;)Ljava/time/temporal/Temporal;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? AddTo(Java.Time.Temporal.ITemporal? temporal);
[<Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;)Ljava/time/temporal/Temporal;", "", ApiSince=26)>]
abstract member AddTo : Java.Time.Temporal.ITemporal -> Java.Time.Temporal.ITemporal
override this.AddTo : Java.Time.Temporal.ITemporal -> Java.Time.Temporal.ITemporal
参数
- temporal
- ITemporal
要调整的临时对象,而不是 null
返回
具有调整的相同类型的对象,而不是 null
实现
- 特性
注解
将此句点添加到指定的临时对象。 这将返回与添加此句点的输入相同的可观察类型的临时对象。 如果时态具有计时表,则它必须是 ISO 时序。 在大多数情况下,使用 Temporal.plus(TemporalAmount)可以更清楚地扭转调用模式。
// these two lines are equivalent, but the second approach is recommended
dateTime = thisPeriod.addTo(dateTime);
dateTime = dateTime.plus(thisPeriod);
计算如下所示。 首先,检查时态的时序,以确保它是 ISO 计时或 null。 其次,如果月份为零,则如果非零,则添加年份;否则,如果非零,则添加年份和月份的组合。 最后,添加任何日期。 此方法可确保将部分时间段添加到部分日期。 例如,可以将年限和/或月添加到 YearMonth,但包含天数的时间段不能。 这种方法还在必要时将年和月加在一起,以确保在月底的正确行为。 此实例不可变,不受此方法调用影响。