ITemporalField.AdjustInto(Object, Int64) 方法

[Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAdjustInto_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalFieldInvoker, 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? AdjustInto(Java.Lang.Object? temporal, long newValue);

[<Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAdjustInto_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalFieldInvoker, 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 AdjustInto : Java.Lang.Object * int64 -> Java.Lang.Object

參數

傳回

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

屬性

RegisterAttribute JavaTypeParametersAttribute

備註

回傳指定時空物件的副本，並包含該欄位集合的值。

此時會回傳一個基於指定物件的新時空物件，且該欄位的值會有所改變。 例如，在 上 LocalDate，這可以用來設定年份、月份或月份。 回傳的物件與指定的物件具有相同的可觀察型態。

在某些情況下，改變欄位的定義並不完全明確。 例如，如果目標物件是代表 1 月 31 日的日期，那麼將月份改為二月就不清楚了。 在這種情況下，實作方負責解決結果。 通常會選擇先前的有效日期，也就是這個例子中二月的最後有效日期。

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

// these two lines are equivalent, but the second approach is recommended
              temporal = thisField.adjustInto(temporal);
              temporal = temporal.with(thisField);

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

實作應使用中 ChronoField可用的欄位執行任何查詢或計算。 若場地無支撐 UnsupportedTemporalTypeException ，必須投擲。

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

的 java.time.temporal.TemporalField.adjustInto(R, long)Java 檔。

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