語言

OffsetTime.Until(ITemporal, ITemporalUnit) 方法

定義

以指定單位計算下一次時間的等待時間。

[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。

適用於