语言

LocalDate.Plus 方法

定义

重载

名称 说明
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。

适用于