語言

ChronoUnit.Between(ITemporal, ITemporal) 方法

定義

計算兩個時間物體之間的時間長度。

[Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "", 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", "", ApiSince=26)>]
abstract member Between : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporal -> int64
override this.Between : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporal -> int64

參數

temporal1Inclusive
ITemporal

是基底時間物件,而非空

temporal2Exclusive
ITemporal

另一個時間對象,排他,非零

傳回

以 temporal1 包含 temporal1Exclusive 與 temporal2Exclusive 之間的時間長度;若 temporal2Exclusive 比 temporal1Exclusive 晚則為正;若較早則為負

實作

屬性

備註

計算兩個時間物體之間的時間長度。 此方法以該單位計算金額。 起點與終點以時間物件形式提供,且必須是相容型態。 實作會在計算金額前,將第二種類型轉換為第一種類型的實例。 如果結束時間在開始之前,結果將為負。 例如,兩個時間物件之間的小時數可用 HOURS.between(startTime, endTime)計算。 計算回傳一個整數,代表兩個時間點之間的完整單位數。 例如,11:30 到 13:29 之間的小時數只會是一小時,因為這距離兩小時差一分鐘。 使用此方法有兩種等效方式。 第一種是直接引用此方法。 第二種是使用 Temporal.until(Temporal, TemporalUnit):

// these two lines are equivalent
between = thisUnit.between(start, end);
between = start.until(end, thisUnit);

選擇應該根據哪種方式讓程式碼更易讀來決定。 例如,此方法允許計算兩個日期之間的天數:

long daysBetween = DAYS.between(start, end);
// or alternatively
long daysBetween = start.until(end, DAYS);

實作應使用ChronoUnit可用的單位或ChronoField可用的欄位來執行任何查詢或計算。 若該單位不被支援,必須拋出 UnsupportedTemporalTypeException。 實作不得更改指定的時間物件。

Java 參考 java.time.temporal.ChronoUnit.between。

適用於