ChronoUnit.AddTo(Object, Int64) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した期間が追加された、指定したテンポラル オブジェクトのコピーを返します。
[Android.Runtime.Register("addTo", "(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? AddTo(Java.Lang.Object? temporal, long amount);[<Android.Runtime.Register("addTo", "(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 AddTo : Java.Lang.Object * int64 -> Java.Lang.Object
override this.AddTo : Java.Lang.Object * int64 -> Java.Lang.Objectパラメーター
- temporal
- Object
調整するテンポラル オブジェクト (null ではない)
- amount
- Int64
加算するこの単位の量(正または負)
返品
調整されたテンポラル オブジェクト (null ではない)
実装
- 属性
注釈
指定した期間が追加された、指定したテンポラル オブジェクトのコピーを返します。 追加される期間は、このユニットの倍数です。 たとえば、このメソッドを使用して、"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, amount);
temporal = temporal.plus(amount, thisUnit);
2 番目の方法である plus(TemporalUnit) を使用することをお勧めします。これは、コードで読む方がわかりやすいためです。 実装では、ChronoUnit で使用可能な単位または ChronoField で使用できるフィールドを使用して、クエリまたは計算を実行する必要があります。 ユニットがサポートされていない場合は、UnsupportedTemporalTypeException をスローする必要があります。 実装では、指定されたテンポラル オブジェクトを変更することはできません。 代わりに、元の調整されたコピーを返す必要があります。 これにより、不変および変更可能な実装に対して同等の安全な動作が提供されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。