Language

ChronoField.AdjustInto(Object, Int64) メソッド

定義

このフィールド セットの値を持つ指定したテンポラル オブジェクトのコピーを返します。

[Android.Runtime.Register("adjustInto", "(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? AdjustInto(Java.Lang.Object? temporal, long newValue);
[<Android.Runtime.Register("adjustInto", "(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 AdjustInto : Java.Lang.Object * int64 -> Java.Lang.Object
override this.AdjustInto : Java.Lang.Object * int64 -> Java.Lang.Object

パラメーター

temporal
Object

調整するテンポラル オブジェクト (null ではない)

newValue
Int64

フィールドの新しい値

返品

調整されたテンポラル オブジェクト (null ではない)

実装

属性

注釈

このフィールド セットの値を持つ指定したテンポラル オブジェクトのコピーを返します。 このフィールドの値が変更された指定されたオブジェクトに基づいて、新しいテンポラル オブジェクトが返されます。 たとえば、LocalDate では、これを使用して年、月、または日を設定できます。 返されるオブジェクトは、指定したオブジェクトと同じ監視可能な型を持ちます。 場合によっては、フィールドの変更が完全には定義されていません。 たとえば、ターゲット オブジェクトが 1 月 31 日を表す日付である場合、月を 2 月に変更することは不明です。 このような場合、実装は結果の解決を担当します。 通常は、前の有効な日付を選択します。この例では、2 月の最後の有効な日になります。 このメソッドを使用する 2 つの同等の方法があります。 1 つ目は、このメソッドを直接呼び出す方法です。 2 つ目は、Temporal.with(TemporalField, long) を使用する方法です。

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

コードで読む方がわかりやすいため、2 番目の方法 with(TemporalField) を使用することをお勧めします。 実装では、ChronoField で使用できるフィールドを使用して、クエリまたは計算を実行する必要があります。 フィールドがサポートされていない場合は、UnsupportedTemporalTypeException をスローする必要があります。 実装では、指定されたテンポラル オブジェクトを変更することはできません。 代わりに、元の調整されたコピーを返す必要があります。 これにより、不変および変更可能な実装に対して同等の安全な動作が提供されます。

Javaリファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象