ITemporalUnit.AddTo(Object, Int64) メソッド

定義

名前空間:

Java.Time.Temporal

アセンブリ:

Mono.Android.dll

指定した期間が追加された、指定したテンポラル オブジェクトのコピーを返します。

[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

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

amount

Int64

加算するこの単位の量(正または負)

返品

Object

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

属性

RegisterAttribute JavaTypeParametersAttribute

注釈

指定した期間が追加された、指定したテンポラル オブジェクトのコピーを返します。

追加される期間は、このユニットの倍数です。 たとえば、このメソッドを使用して、"days" を表すインスタンスでこのメソッドを呼び出し、日付と期間 "3" を渡すことで、日付に "3 日" を追加できます。 加算する期間は負の値で、減算に相当します。

このメソッドを使用する 2 つの同等の方法があります。 1 つ目は、このメソッドを直接呼び出す方法です。 2 つ目は、 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) 2 番目のアプローチを使用することをお勧めします。

実装では、 ChronoUnit で使用可能な単位または ChronoFieldで使用可能なフィールドを使用して、クエリまたは計算を実行する必要があります。 ユニットがサポートされていない場合は、 UnsupportedTemporalTypeException をスローする必要があります。

実装では、指定されたテンポラル オブジェクトを変更することはできません。 代わりに、元の調整されたコピーを返す必要があります。 これにより、不変および変更可能な実装に対して同等の安全な動作が提供されます。

Javaドキュメント。

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