LocalDate.Until 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | 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。