YearMonth.Plus 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Plus(Int64, ITemporalUnit) |
回傳一份該年度月份的副本,並加上指定金額。 |
| Plus(ITemporalAmount) |
回傳一份該年度月份的副本,並加上指定金額。 |
Plus(Int64, ITemporalUnit)
回傳一份該年度月份的副本,並加上指定金額。
[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
參數
- amountToAdd
- Int64
加到結果中的單位數可能為負數
- unit
- ITemporalUnit
要加的金額單位,不是 null
傳回
一個基於該年月並加上指定金額的 YearMonth,而非無效
實作
- 屬性
備註
回傳一份該年度月份的副本,並加上指定金額。 此時會回傳一個 YearMonth,並以單位為單位計算的金額。 若無法新增金額,例如該單位不支援或其他原因,則會拋出例外。 如果場是 ChronoUnit,則此處實作加法。 支援欄位的行為如下:MONTHS - 回傳一個加了指定月份數的 YearMonth。 這相當於 plusMonths(long)。 YEARS - 返回一個年月,並加上指定的年數。 這相當於 plusYears(long)。 十年 - 返回一年月,並加上指定的十年數。 這相當於呼叫 plusYears(long),但金額乘以 10。 百年(CENTURIES)-每年回報,月中加上指定世紀數。 這相當於打電話給 plusYears(long),金額乘以 100。 千年-返回一年月,並加上指定的千年數。 這相當於撥打 plusYears(long) 並將金額乘以 1,000。 ERAS - 返回一個年月,並加上指定數量的 ERAS。 僅支援兩個時代,因此數量必須是一、零或負一。 若金額非零,則年份會變動,使得該年不變。 所有其他 ChronoUnit 實例都會拋出 UnsupportedTemporalTypeException。 若欄位不是 ChronoUnit,則透過呼叫 TemporalUnit.addTo(Temporal, long)並將此參數傳遞為參數,得出此方法的結果。 在這種情況下,單位決定是否以及如何進行加法。 此實例是不可變且不受此方法呼叫影響的。
Java 參考 java.time.YearMonth.plus。
適用於
Plus(ITemporalAmount)
回傳一份該年度月份的副本,並加上指定金額。
[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
參數
- amountToAdd
- ITemporalAmount
要加的金額,不是零
傳回
a YearMonth 基於此年月加上的加值,而非無效
- 屬性
備註
回傳一份該年度月份的副本,並加上指定金額。 這會回傳一個基於此的 YearMonth,並加上指定的金額。 金額通常是 Period,但也可能是其他實作 TemporalAmount 介面的類型。 計算會透過呼叫 TemporalAmount.addTo(Temporal) 委派給 amount 物件。 金額實作可以自由實現加法,但通常會回調 plus(long, TemporalUnit)。 請查閱金額實施的文件,判斷是否能成功新增。 此實例是不可變且不受此方法呼叫影響的。
Java 參考 java.time.YearMonth.plus。