Instant.Plus 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Plus(ITemporalAmount) |
回傳此瞬間的副本，並加上指定的金額。 |
| Plus(Int64, ITemporalUnit) |
回傳此瞬間的副本，並加上指定的金額。 |
Plus(ITemporalAmount)
回傳此瞬間的副本，並加上指定的金額。
[Android.Runtime.Register("plus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/Instant;", "", ApiSince=26)]
public Java.Time.Instant? Plus(Java.Time.Temporal.ITemporalAmount? amountToAdd);[<Android.Runtime.Register("plus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/Instant;", "", ApiSince=26)>]
member this.Plus : Java.Time.Temporal.ITemporalAmount -> Java.Time.Instant參數
- amountToAdd
- ITemporalAmount
TemporalAmount：要加的金額，不是 null
傳回
即刻即刻，基於此瞬間加上加法，而非空
- 屬性
備註
回傳此瞬間的副本，並加上指定的金額。 這會回傳一個即時的，基於這個，並加上指定的金額。 金額通常是 Duration，但也可能是其他實現 TemporalAmount 介面的類型。 計算會透過呼叫 TemporalAmount.addTo（Temporal） 委派給 amount 物件。 金額實作可以自由實現任何加法，但通常會回調 plus（long，TemporalUnit）。 請查閱金額實施的文件，判斷是否能成功新增。 此實例是不可變且不受此方法呼叫影響的。
拋出：數值溢位發生時的 ArithmeticException
拋出次數：若無法進行加法，則使用DateTimeException
Android 參考資料。java.time.Instant.plus
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
Plus(Int64, ITemporalUnit)
回傳此瞬間的副本，並加上指定的金額。
[Android.Runtime.Register("plus", "(JLjava/time/temporal/TemporalUnit;)Ljava/time/Instant;", "", 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/Instant;", "", 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
long：將該單位加到結果中，可能為負數
- unit
- ITemporalUnit
TemporalUnit：要加的金額單位，不是 null
傳回
即基於此瞬間且加上指定金額的即時，而非空
實作
- 屬性
備註
回傳此瞬間的副本，並加上指定的金額。 這會根據這個數字回傳一個即時值，並以單位為單位計算的金額。 若無法新增金額，例如該單位不支援或其他原因，則會拋出例外。 如果場是 ChronoUnit，則此處實作加法。 支援的場表現如下：NANOS - 回傳一個加了指定奈秒數的瞬間。 這相當於 plusNanos（long）。 MICROS - 回傳一個即時，並加上指定的微秒數。 這相當於 plusNanos（long） 乘以 1,000。 MILLIS - 回傳一個加滿指定毫秒數的瞬間。 這相當於 plusNanos（long） 乘以 1,000,000。 秒數 - 回傳一個即時時間，並加上指定秒數。 這相當於 plusSeconds（long）。 MINUTES - 回傳一個加了指定分鐘數的瞬間。 這相當於 plusSeconds（long） 的長度乘以 60。 HOURS - 回傳一個即時時間，並加上指定時數。 這相當於 plusSeconds（long） 的數量乘以 3,600。 HALF_DAYS - 回傳一個加了指定半天數的瞬間。 這相當於 plusSeconds（long），將這個數量乘以 43,200（12 小時）。 DAYS - 回傳一個即時，並加上指定的天數。 這相當於 plusSeconds（long）乘以 86,400（24 小時）。 所有其他 ChronoUnit 實例都會拋出 UnsupportedTemporalTypeException。 若欄位不是 ChronoUnit，則透過呼叫 TemporalUnit.addTo（Temporal， long）並將此參數傳遞為參數，得出此方法的結果。 在這種情況下，單位決定是否以及如何進行加法。 此實例是不可變且不受此方法呼叫影響的。
拋出：數值溢位發生時的 ArithmeticException
拋出次數：若無法進行加法，則使用DateTimeException
拋出：UnsupportedTemporalTypeException 若該單位不被支援
Android 參考資料。java.time.Instant.plus
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。