YearMonth.Plus Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.