YearMonth.Until(ITemporal, ITemporalUnit) 方法

定義

命名空間:

Java.Time

組件:

Mono.Android.dll

以指定單位計算距離下一年月的時間。

[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

結束日期，排他性，轉換成 YearMonth，而非 null

unit

ITemporalUnit

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

傳回

Int64

這個年月與年底年月之間的時間長度

實作

Until(ITemporal, ITemporalUnit)

屬性

RegisterAttribute

備註

以指定單位計算距離下一年月的時間。 這會以單一 TemporalUnit 來計算兩個 YearMonth 物件之間的時間長短。 起點和終點分別是這個和指定的年月。 如果結束時間在開始之前，結果將為負。 此方法所傳遞的時間會透過 from（TemporalAccessor） 轉換成 YearMonth。 例如，兩個年月之間的年份可以用 startYearMonth.until（endYearMonth， YEARS） 計算。 計算回傳一個整數，代表兩個年月間的完整單位數。 例如，2012-06年至2032-05年之間的十年數將只有一個十年，因為距離兩個十年還有一個月。 使用此方法有兩種等效方式。 第一是啟動此方法。 第二種是使用 TemporalUnit.between（Temporal， Temporal）：選擇應該根據哪種方式讓程式碼更易讀來決定。 此計算即以此方法實作於 ChronoUnit。 支援的單位包括月份、年份、十年、世紀、千年和時代。 其他 ChronoUnit 的值會拋出例外。 若該單位不是 ChronoUnit，則透過呼叫 TemporalUnit.between（Temporal， Temporal），將此作為第一個參數，將轉換後的 temporal 輸入作為第二個參數來得到。 此實例是不可變且不受此方法呼叫影響的。

Java 參考 java.time.YearMonth.until。