語言

Instant.Until 方法

定義

多載

名稱 Description
Until(ITemporal, ITemporalUnit)

以指定單位計算距離下一個時刻的時間。

Until(Instant)

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:用來衡量金額的單位,不是零

傳回

從此瞬間到結束時刻之間的時間長短

實作

屬性

備註

以指定單位計算距離下一個時刻的時間。 這會以單一 TemporalUnit 來計算兩個瞬間物件之間的時間長度。 起點與終點分別是此點及指定的瞬間。 如果結束時間在開始之前,結果將為負。 計算回傳一個整數,代表兩個時刻之間的完整單位數。 傳遞給此方法的時間會使用 from(TemporalAccessor) 轉換成瞬間。 例如,兩個日期之間的秒數可以用 startInstant.until(endInstant, SECONDS) 計算。 使用此方法有兩種等效方式。 第一是啟動此方法。 第二種是使用 TemporalUnit.between(Temporal, Temporal):選擇應該根據哪種方式讓程式碼更易讀來決定。 此計算即以此方法實作於 ChronoUnit。 支援 NANOS、MICROS、MILLIS、SECONDS、MINUTES、HOURS、HALF_DAYS 和 DAYS 等單位。 其他 ChronoUnit 的值會拋出例外。 若該單位不是 ChronoUnit,則透過呼叫 TemporalUnit.between(Temporal, Temporal),將此作為第一個參數,將轉換後的 temporal 輸入作為第二個參數來得到。 此實例是不可變且不受此方法呼叫影響的。

拋出:數值溢位發生時的 ArithmeticException

擲出次數:如果無法計算金額,或無法將結束時段轉換為瞬間,則使用 DateTimeException

拋出:UnsupportedTemporalTypeException 若該單位不被支援

Android 參考資料。java.time.Instant.until

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於

Until(Instant)

[Android.Runtime.Register("until", "(Ljava/time/Instant;)Ljava/time/Duration;", "", ApiSince=37)]
public Java.Time.Duration Until(Java.Time.Instant endExclusive);
[<Android.Runtime.Register("until", "(Ljava/time/Instant;)Ljava/time/Duration;", "", ApiSince=37)>]
member this.Until : Java.Time.Instant -> Java.Time.Duration

參數

endExclusive
Instant

傳回

屬性

適用於