語言

LocalDate.Until 方法

定義

多載

名稱 Description
Until(IChronoLocalDate)

將此日期與另一個日期之間的期間計算為一個期間。

Until(ITemporal, ITemporalUnit)

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

Until(IChronoLocalDate)

將此日期與另一個日期之間的期間計算為一個期間。

[Android.Runtime.Register("until", "(Ljava/time/chrono/ChronoLocalDate;)Ljava/time/Period;", "", ApiSince=26)]
public Java.Time.Chrono.IChronoPeriod? Until(Java.Time.Chrono.IChronoLocalDate? endDateExclusive);
[<Android.Runtime.Register("until", "(Ljava/time/chrono/ChronoLocalDate;)Ljava/time/Period;", "", ApiSince=26)>]
abstract member Until : Java.Time.Chrono.IChronoLocalDate -> Java.Time.Chrono.IChronoPeriod
override this.Until : Java.Time.Chrono.IChronoLocalDate -> Java.Time.Chrono.IChronoPeriod

參數

endDateExclusive
IChronoLocalDate

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

傳回

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

實作

屬性

備註

將此日期與另一個日期之間的期間計算為一個期間。 此系統以年、月、天計算兩個日期之間的時間。 起點和終點就是這個日期和指定的日期。 如果結束時間在開始之前,結果將為負。 負號在每年、每個月和每一天都會是一樣的。 計算是透過 ISO 日曆系統進行的。 如有需要,輸入日期會轉換為 ISO。 雖然有寫入開始日期,但沒有結束日期。 這個期間是透過移除完整的月份,再計算剩餘的天數,並調整以確保兩者星座相同來計算。 月數再以12個月年為基準標準化為年和月。 若月底日期大於或等於起始日期,則該月即為完整。 例如,從2010-01-15到2011-03-18,是「1年2個月3天」。 使用此方法有兩種等效方式。 第一是啟動此方法。 第二種是使用 Period.between(LocalDate, LocalDate):選擇應該根據哪種方式讓程式碼更易讀來決定。

Java 參考 java.time.LocalDate.until。

適用於

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

結束日期,排他性,轉換成 LocalDate,而非空日期

unit
ITemporalUnit

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

傳回

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

實作

屬性

備註

以指定單位計算到下一個日期的時間。 此系統以單一 TemporalUnit 計算兩個 LocalDate 物件之間的時間長短。 起點和終點就是這個日期和指定的日期。 如果結束時間在開始之前,結果將為負。 傳送給此方法的時間會使用 from(TemporalAccessor) 轉換成 LocalDate。 例如,兩個日期之間的天數可以用 startDate.until(endDate, DAYS) 計算。 計算回傳一個整數,代表兩個日期之間的完整單位數。 例如,2012-06-15 到 2012-08-14 之間的月份金額只會是一個月,因為差一天就差兩個月。 使用此方法有兩種等效方式。 第一是啟動此方法。 第二種是使用 TemporalUnit.between(Temporal, Temporal):選擇應該根據哪種方式讓程式碼更易讀來決定。 此計算即以此方法實作於 ChronoUnit。 支援的單位包括日、週、月、年、十年、世紀、千年和時代。 其他 ChronoUnit 的值會拋出例外。 若該單位不是 ChronoUnit,則透過呼叫 TemporalUnit.between(Temporal, Temporal),將此作為第一個參數,將轉換後的 temporal 輸入作為第二個參數來得到。 此實例是不可變且不受此方法呼叫影響的。

Java 參考 java.time.LocalDate.until。

適用於