ITemporalUnit.Between(ITemporal, ITemporal) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
2 つのテンポラル オブジェクト間の時間を計算します。
[Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "GetBetween_Ljava_time_temporal_Temporal_Ljava_time_temporal_Temporal_Handler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
public long Between (Java.Time.Temporal.ITemporal? temporal1Inclusive, Java.Time.Temporal.ITemporal? temporal2Exclusive);
[<Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "GetBetween_Ljava_time_temporal_Temporal_Ljava_time_temporal_Temporal_Handler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member Between : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporal -> int64
パラメーター
- temporal1Inclusive
- ITemporal
null ではなく、基本テンポラル オブジェクト
- temporal2Exclusive
- ITemporal
もう 1 つのテンポラル オブジェクト (null ではなく排他的)
戻り値
この単位の観点からテンポラル 1Inclusive と temporal2Exclusive の間の時間の量。temporal2Exclusive が temporal1Inclusive より後の場合は正、前の場合は負
- 属性
注釈
2 つのテンポラル オブジェクト間の時間を計算します。
これにより、この単位に関して金額が計算されます。 始点と終点はテンポラル オブジェクトとして提供され、互換性のある型である必要があります。 実装では、量を計算する前に、2 番目の型を最初の型のインスタンスに変換します。 終了が開始前の場合、結果は負になります。 たとえば、2 つのテンポラル オブジェクト間の時間単位の量は HOURS.between(startTime, endTime)
、
この計算では、2 つのテンポラル間の完全な単位数を表す整数が返されます。 たとえば、時刻 11:30 から 13:29 までの時間単位の量は、2 時間の 1 分足りずに 1 時間のみになります。
このメソッドを使用する 2 つの同等の方法があります。 1 つ目は、このメソッドを直接呼び出す方法です。 2 つ目は、次を使用する方法 Temporal#until(Temporal, TemporalUnit)
です。
// these two lines are equivalent
between = thisUnit.between(start, end);
between = start.until(end, thisUnit);
選択は、コードをより読みやすくするための選択に基づいて行う必要があります。
たとえば、次のメソッドを使用すると、2 つの日付間の日数を計算できます。
long daysBetween = DAYS.between(start, end);
// or alternatively
long daysBetween = start.until(end, DAYS);
実装では、使用可能な単位または使用可能な ChronoUnit
フィールド ChronoField
を使用して、クエリまたは計算を実行する必要があります。 ユニットがサポートされていない場合は、 UnsupportedTemporalTypeException
スローする必要があります。 実装では、指定されたテンポラル オブジェクトを変更することはできません。
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。