ITemporalUnit.AddTo(Object, Int64) 方法

定義

命名空間:: Java.Time.Temporal

組件:: Mono.Android.dll

重要

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

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

[Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", 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;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member AddTo : Java.Lang.Object * int64 -> Java.Lang.Object

參數

temporal: Object

調整的時間對象，而非空

amount: Int64

該單位的加量，正負

傳回

Object

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

屬性: RegisterAttribute JavaTypeParametersAttribute

備註

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

所加的週期是該單位的倍數。例如，此方法可透過在代表「天」的實例中呼叫此方法，將日期與期間「3」相符，來為日期加上「3天」。要加的週期可以為負，等同於減法。

使用此方法有兩種等效方式。第一種是直接引用此方法。第二種是使用 Temporal#plus(long, TemporalUnit)：

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

建議採用第二種方法， plus(TemporalUnit)因為在程式碼中閱讀起來更清晰。

實作應使用中 ChronoUnit 可用的單位或欄位 ChronoField執行查詢或計算。若單位無支撐 UnsupportedTemporalTypeException ，必須丟棄。

實作不得改變指定的時間物件。取而代之的是，必須歸還經過調整的原件副本。這為不可變與可變實作提供等效且安全的行為。

Java 文件 java.time.temporal.TemporalUnit.addTo(R, long)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於