ChronoUnit.AddTo(Object, Int64) 方法

定義

命名空間:: Java.Time.Temporal

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

回傳一份指定時間物件的副本，並加上指定的週期。

[Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "", ApiSince=26)]
[Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })]
public Java.Lang.Object? AddTo(Java.Lang.Object? temporal, long amount);

[<Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member AddTo : Java.Lang.Object * int64 -> Java.Lang.Object
override this.AddTo : Java.Lang.Object * int64 -> Java.Lang.Object

參數

temporal: Object

調整的時間對象，而非空

amount: Int64

該單位的加量，正負

傳回

Object

調整後的時間物件，而非零

實作

AddTo(Object, Int64)

屬性: RegisterAttribute JavaTypeParametersAttribute

備註

回傳一份指定時間物件的副本，並加上指定的週期。所加的週期是該單位的倍數。例如，此方法可透過在代表「天」的實例中呼叫此方法，將日期與期間「3」相符，來為日期加上「3天」。要加的週期可以為負，等同於減法。使用此方法有兩種等效方式。第一種是直接引用此方法。第二種是使用 Temporal.plus（long， TemporalUnit）：

// these two lines are equivalent, but the second approach is recommended
temporal = thisUnit.addTo(temporal, amount);
temporal = temporal.plus(amount, thisUnit);

建議採用第二種方法，plus（TemporalUnit），因為在程式碼中閱讀起來更清晰。實作應使用ChronoUnit可用的單位或ChronoField可用的欄位來執行任何查詢或計算。若該單位不被支援，必須拋出 UnsupportedTemporalTypeException。實作不得改變指定的時間物件。取而代之的是，必須歸還經過調整的原件副本。這為不可變與可變實作提供等效且安全的行為。

Java 參考 java.time.temporal.ChronoUnit.addTo。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於