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

注釈

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

追加された期間は、このユニットの倍数です。 たとえば、このメソッドを使用すると、"日" を表すインスタンスでこのメソッドを呼び出し、日付と期間 "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 番目のアプローチを使用することをお勧めします。

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

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

の Java ドキュメント java.time.temporal.TemporalUnit.addTo(R, long)。

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