Year.Until(ITemporal, ITemporalUnit) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した単位の観点から、別の年までの時間を計算します。
[Android.Runtime.Register("until", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/TemporalUnit;)J", "", ApiSince=26)]
public long Until(Java.Time.Temporal.ITemporal? endExclusive, Java.Time.Temporal.ITemporalUnit? unit);[<Android.Runtime.Register("until", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/TemporalUnit;)J", "", ApiSince=26)>]
abstract member Until : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporalUnit -> int64
override this.Until : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporalUnit -> int64パラメーター
- endExclusive
- ITemporal
終了日 (排他)、null ではなく年に変換されます。
- unit
- ITemporalUnit
null ではなく、量を測定する単位
返品
この年から終了年までの時間の長さを指定します。
実装
- 属性
注釈
指定した単位の観点から、別の年までの時間を計算します。 これにより、1 つのテンポラルユニットの観点から、2 つの Year オブジェクト間の時間の量が計算されます。 始点と終点は、この年と指定された年です。 終了が開始前の場合、結果は負になります。 このメソッドに渡されるテンポラルは、from(TemporalAccessor) を使用して Year に変換されます。 たとえば、2 年の間の数十年間の金額は、startYear.until(endYear, DECADES) を使用して計算できます。 この計算では、2 年間の完全な単位数を表す整数が返されます。 たとえば、2012 年から 2031 年までの数十年間の金額は、20 年から 1 年足りずに 10 年になります。 このメソッドを使用する 2 つの同等の方法があります。 1 つ目は、このメソッドを呼び出す方法です。 2 つ目は、TemporalUnit.between(テンポラル、テンポラル) を使用することです。コードをより読みやすくするために、選択を行う必要があります。 この計算は、ChronoUnit のこのメソッドで実装されます。 年、数十年、世紀、千年、年号の単位がサポートされています。 その他の ChronoUnit 値は例外をスローします。 ユニットが ChronoUnit でない場合、このメソッドの結果は、TemporalUnit.between(テンポラル、テンポラル) を呼び出して、これを最初の引数として、変換された入力テンポラルを 2 番目の引数として渡すことによって取得されます。 このインスタンスは不変であり、このメソッド呼び出しの影響を受けません。