YearMonth.Plus Method

Definition

Overloads

Name Description
Plus(Int64, ITemporalUnit)

Returns a copy of this year-month with the specified amount added.

Plus(ITemporalAmount)

Returns a copy of this year-month with the specified amount added.

Plus(Int64, ITemporalUnit)

Returns a copy of this year-month with the specified amount added.

[Android.Runtime.Register("plus", "(JLjava/time/temporal/TemporalUnit;)Ljava/time/YearMonth;", "", 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/YearMonth;", "", 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

Parameters

amountToAdd
Int64

the amount of the unit to add to the result, may be negative

unit
ITemporalUnit

the unit of the amount to add, not null

Returns

a YearMonth based on this year-month with the specified amount added, not null

Implements

Attributes

Remarks

Returns a copy of this year-month with the specified amount added. This returns a YearMonth, based on this one, with the amount in terms of the unit added. If it is not possible to add the amount, because the unit is not supported or for some other reason, an exception is thrown. If the field is a ChronoUnit then the addition is implemented here. The supported fields behave as follows: MONTHS - Returns a YearMonth with the specified number of months added. This is equivalent to plusMonths(long). YEARS - Returns a YearMonth with the specified number of years added. This is equivalent to plusYears(long). DECADES - Returns a YearMonth with the specified number of decades added. This is equivalent to calling plusYears(long) with the amount multiplied by 10. CENTURIES - Returns a YearMonth with the specified number of centuries added. This is equivalent to calling plusYears(long) with the amount multiplied by 100. MILLENNIA - Returns a YearMonth with the specified number of millennia added. This is equivalent to calling plusYears(long) with the amount multiplied by 1,000. ERAS - Returns a YearMonth with the specified number of eras added. Only two eras are supported so the amount must be one, zero or minus one. If the amount is non-zero then the year is changed such that the year-of-era is unchanged. All other ChronoUnit instances will throw an UnsupportedTemporalTypeException. If the field is not a ChronoUnit, then the result of this method is obtained by invoking TemporalUnit.addTo(Temporal, long) passing this as the argument. In this case, the unit determines whether and how to perform the addition. This instance is immutable and unaffected by this method call.

Java reference for java.time.YearMonth.plus.

Applies to

Plus(ITemporalAmount)

Returns a copy of this year-month with the specified amount added.

[Android.Runtime.Register("plus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/YearMonth;", "", ApiSince=26)]
public Java.Time.YearMonth? Plus(Java.Time.Temporal.ITemporalAmount? amountToAdd);
[<Android.Runtime.Register("plus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/YearMonth;", "", ApiSince=26)>]
member this.Plus : Java.Time.Temporal.ITemporalAmount -> Java.Time.YearMonth

Parameters

amountToAdd
ITemporalAmount

the amount to add, not null

Returns

a YearMonth based on this year-month with the addition made, not null

Attributes

Remarks

Returns a copy of this year-month with the specified amount added. This returns a YearMonth, based on this one, with the specified amount added. The amount is typically Period but may be any other type implementing the TemporalAmount interface. The calculation is delegated to the amount object by calling TemporalAmount.addTo(Temporal). The amount implementation is free to implement the addition in any way it wishes, however it typically calls back to plus(long, TemporalUnit). Consult the documentation of the amount implementation to determine if it can be successfully added. This instance is immutable and unaffected by this method call.

Java reference for java.time.YearMonth.plus.

Applies to