ITemporalUnit.Between(ITemporal, ITemporal) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
計算兩個時間物體之間的時間長度。
[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
是基底時間物件,而非空
- 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 ,必須丟棄。 實作不得更改指定的時間物件。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。