Year.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

結束日期為專屬，轉換為年份，而非無效

unit

ITemporalUnit

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

傳回

Int64

今年到年底之間的時間

實作

Until(ITemporal, ITemporalUnit)

屬性

RegisterAttribute

備註

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

Java 參考 java.time.Year.until。