語言

IChronoLocalDate.Until 方法

定義

多載

名稱 Description
Until(ITemporal, ITemporalUnit)

以指定單位計算到下一個日期的時間。

Until(IChronoLocalDate)

計算此日期與另一個日期之間的時間。ChronoPeriod

Until(ITemporal, ITemporalUnit)

以指定單位計算到下一個日期的時間。

[Android.Runtime.Register("until", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/TemporalUnit;)J", "GetUntil_Ljava_time_temporal_Temporal_Ljava_time_temporal_TemporalUnit_Handler:Java.Time.Chrono.IChronoLocalDateInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", 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", "GetUntil_Ljava_time_temporal_Temporal_Ljava_time_temporal_TemporalUnit_Handler:Java.Time.Chrono.IChronoLocalDateInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member Until : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporalUnit -> int64

參數

endExclusive
ITemporal

結束日期,排他性,且在同一時間軸中轉換為 a ChronoLocalDate ,而非無效

unit
ITemporalUnit

用來測量量的單位,而非零

傳回

此日期與結束日期之間的時間長短

實作

屬性

備註

以指定單位計算到下一個日期的時間。

此方法以單一 TemporalUnit為單位計算兩個ChronoLocalDate物體之間的時間長短。 起點與終點為 this 指定日期。 如果結束時間在開始之前,結果將為負。 Temporal傳遞到此方法的 會轉換為 ChronoLocalDate 使用 Chronology#date(TemporalAccessor)。 計算回傳一個整數,代表兩個日期之間的完整單位數。 例如,兩個日期之間的天數可用 來計算 startDate.until(endDate, DAYS)。

使用此方法有兩種等效方式。 第一是啟動此方法。 第二種是使用 TemporalUnit#between(Temporal, Temporal):

// these two lines are equivalent
              amount = start.until(end, MONTHS);
              amount = MONTHS.between(start, end);

選擇應該根據哪種方式讓程式碼更易讀來決定。

此計算在此方法中實作。ChronoUnit 單元 DAYS、 WEEKS、 MONTHS、 YEARSDECADES、 CENTURIES、 MILLENNIAERAS 應由所有實作支援。 其他 ChronoUnit 值則會拋出例外。

若單位不是 ChronoUnit,則此方法的結果是透過調 TemporalUnit.between(Temporal, Temporal) 用 passing this 作為第一個參數,並將轉換後的時間輸入作為第二個參數來得到。

此實例是不可變且不受此方法呼叫影響的。

Java 文件 java.time.chrono.ChronoLocalDate.until(java.time.temporal.Temporal, java.time.temporal.TemporalUnit)。

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

適用於

Until(IChronoLocalDate)

計算此日期與另一個日期之間的時間。ChronoPeriod

[Android.Runtime.Register("until", "(Ljava/time/chrono/ChronoLocalDate;)Ljava/time/chrono/ChronoPeriod;", "GetUntil_Ljava_time_chrono_ChronoLocalDate_Handler:Java.Time.Chrono.IChronoLocalDateInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
public Java.Time.Chrono.IChronoPeriod? Until(Java.Time.Chrono.IChronoLocalDate? endDateExclusive);
[<Android.Runtime.Register("until", "(Ljava/time/chrono/ChronoLocalDate;)Ljava/time/chrono/ChronoPeriod;", "GetUntil_Ljava_time_chrono_ChronoLocalDate_Handler:Java.Time.Chrono.IChronoLocalDateInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member Until : Java.Time.Chrono.IChronoLocalDate -> Java.Time.Chrono.IChronoPeriod

參數

endDateExclusive
IChronoLocalDate

結束日期,排他性,可屬於任何時間軸,但不可

傳回

此日期與結束日期之間的期間,非無效

屬性

備註

計算此日期與另一個日期之間的時間。ChronoPeriod

此方法計算兩個日期之間的期間。 所有提供的時間軸皆以年、月、天計算期間,但 ChronoPeriod API 允許使用其他單位來表示該時期。

起點與終點為 this 指定日期。 如果結束時間在開始之前,結果將為負。 負號在每年、每個月和每一天都會是一樣的。

計算依據此日期的時間順序進行。 如有需要,輸入日期會被轉換成匹配。

此實例是不可變且不受此方法呼叫影響的。

Java 文件 java.time.chrono.ChronoLocalDate.until(java.time.chrono.ChronoLocalDate)。

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

適用於