ChronoUnit.Between(ITemporal, ITemporal) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
計算兩個時間物體之間的時間長度。
[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。