OffsetTime.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
結束時間,排他時間,轉換成偏移時間,而非空時間
- unit
- ITemporalUnit
用來測量量的單位,而非零
傳回
從此時間到終點的時間
實作
- 屬性
備註
以指定單位計算下一次時間的等待時間。 這會以單一 TemporalUnit 來計算兩個 OffsetTime 物件之間的時間長度。 起點和終點就是這個時間和指定的時間。 如果結束時間在開始之前,結果將為負。 例如,兩次時間之間的小時數可以用 startTime.until(endTime, HOURS) 計算。 傳遞給此方法的時間會使用 from(TemporalAccessor) 轉換成 OffsetTime。 若兩時間間的偏移不同,則指定的結束時間會被正規化為與此時間相同的偏移。 計算回傳一個整數,代表兩個時間之間的完整單位數。 例如,11:30Z到13:29Z之間的小時數只會是一小時,因為這比兩小時還差一分鐘。 使用此方法有兩種等效方式。 第一是啟動此方法。 第二種是使用 TemporalUnit.between(Temporal, Temporal):選擇應該根據哪種方式讓程式碼更易讀來決定。 此計算即以此方法實作於 ChronoUnit。 支援 NANOS、MICROS、MILLIS、SECONDS、MINUTES、HOUR 及 HALF_DAYS 等單位。 其他 ChronoUnit 的值會拋出例外。 若該單位不是 ChronoUnit,則透過呼叫 TemporalUnit.between(Temporal, Temporal),將此作為第一個參數,將轉換後的 temporal 輸入作為第二個參數來得到。 此實例是不可變且不受此方法呼叫影響的。
Java 參考 java.time.OffsetTime.until。