LocalDate.Plus 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| Plus(ITemporalAmount) |
返回此日期的副本,其中包含添加的指定金额。 |
| Plus(Int64, ITemporalUnit) |
返回此日期的副本,其中包含添加的指定金额。 |
Plus(ITemporalAmount)
返回此日期的副本,其中包含添加的指定金额。
[Android.Runtime.Register("plus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/LocalDate;", "", ApiSince=26)]
public Java.Time.LocalDate? Plus(Java.Time.Temporal.ITemporalAmount? amountToAdd);
[<Android.Runtime.Register("plus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/LocalDate;", "", ApiSince=26)>]
member this.Plus : Java.Time.Temporal.ITemporalAmount -> Java.Time.LocalDate
参数
- amountToAdd
- ITemporalAmount
要添加的量,而不是 null
返回
基于此日期的 LocalDate,添加时不为 null
- 特性
注解
返回此日期的副本,其中包含添加的指定金额。 这会根据此日期返回 LocalDate,并添加指定的金额。 该量通常是 Period,但可以是实现 TemporalAmount 接口的任何其他类型。 通过调用 TemporalAmount.addTo(Temporal)将计算委托给 amount 对象。 数量实现可以自由地以任何希望的方式实现添加,但它通常调用回加(long,TemporalUnit)。 请参阅数量实现的文档,以确定是否可以成功添加。 此实例不可变,不受此方法调用影响。
Java参考java.time.LocalDate.plus。
适用于
Plus(Int64, ITemporalUnit)
返回此日期的副本,其中包含添加的指定金额。
[Android.Runtime.Register("plus", "(JLjava/time/temporal/TemporalUnit;)Ljava/time/LocalDate;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? Plus(long amountToAdd, Java.Time.Temporal.ITemporalUnit? unit);
[<Android.Runtime.Register("plus", "(JLjava/time/temporal/TemporalUnit;)Ljava/time/LocalDate;", "", ApiSince=26)>]
abstract member Plus : int64 * Java.Time.Temporal.ITemporalUnit -> Java.Time.Temporal.ITemporal
override this.Plus : int64 * Java.Time.Temporal.ITemporalUnit -> Java.Time.Temporal.ITemporal
参数
- amountToAdd
- Int64
要添加到结果中的单位量可能是负数
- unit
- ITemporalUnit
要添加的量单位,而不是 null
返回
基于此日期的 LocalDate,添加的指定金额,而不是 null
实现
- 特性
注解
返回此日期的副本,其中包含添加的指定金额。 这将基于此值返回 LocalDate,该单位的添加量。 如果无法添加量,因为该单位不受支持或出于其他原因,则会引发异常。 在某些情况下,添加金额可能会导致生成的日期无效。 例如,将一个月添加到 1 月 31 日将导致 2 月 31 日。 在这种情况下,该单位负责解决日期。 通常,它将选择上一个有效日期,这将是此示例中 2 月的最后一个有效日期。 如果该字段为 ChronoUnit,则在此处实现添加。 支持的字段的行为如下:DAYS - 返回添加指定天数的 LocalDate。 这相当于 plusDays(long)。 WEEKS - 返回添加指定周数的 LocalDate。 这相当于 plusWeeks(long),使用 7 天一周。 MONTH - 返回添加指定月份数的 LocalDate。 这相当于 plusMonths(long)。 除非新月和年份无效,否则一个月的日期将保持不变。 在这种情况下,日数调整为新月和年份的最大有效值。 YEARS - 返回已添加指定年数的 LocalDate。 这相当于 plusYears(long)。 除非新月和年份无效,否则一个月的日期将保持不变。 在这种情况下,日数调整为新月和年份的最大有效值。 DECADES - 返回具有指定数十年的 LocalDate。 这相当于调用 plusYears(long),其金额乘以 10。 除非新月和年份无效,否则一个月的日期将保持不变。 在这种情况下,日数调整为新月和年份的最大有效值。 CENTURIES - 返回具有指定世纪数的 LocalDate。 这相当于调用 plusYears(long),其金额乘以 100。 除非新月和年份无效,否则一个月的日期将保持不变。 在这种情况下,日数调整为新月和年份的最大有效值。 MILLENNIA - 返回一个 LocalDate,并添加指定的数千年。 这相当于调用 plusYears(long),其金额乘以 1,000。 除非新月和年份无效,否则一个月的日期将保持不变。 在这种情况下,日数调整为新月和年份的最大有效值。 ERAS - 返回一个 LocalDate,其中包含添加的指定纪元数。 仅支持两个纪元,因此数量必须是一个、零或减一个。 如果金额为非零,则更改年份,使纪年不变。 除非新月和年份无效,否则一个月的日期将保持不变。 在这种情况下,日数调整为新月和年份的最大有效值。 所有其他 ChronoUnit 实例都将引发 UnsupportedTemporalTypeException。 如果字段不是 ChronoUnit,则通过调用 TemporalUnit.addTo(Temporal, long)作为参数来获取此方法的结果。 在这种情况下,单元确定是否以及如何执行加法。 此实例不可变,不受此方法调用影响。
Java参考java.time.LocalDate.plus。