ITemporal.Until(ITemporal, ITemporalUnit) 方法

定義

命名空間:

Java.Time.Temporal

組件:

Mono.Android.dll

以指定單位計算下一個時間點的時間。

[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.Temporal.ITemporalInvoker, 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.Temporal.ITemporalInvoker, 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

終點時間、排他、轉換成與此物件相同類型，而非空

unit

ITemporalUnit

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

傳回

Int64

以單位單位計算的時間點與指定對象之間的時間長短;正數表示指定物體比此物晚;負數表示該物體早於此物體

屬性

RegisterAttribute

備註

以指定單位計算下一個時間點的時間。

此方法以單一 TemporalUnit時間計算兩個時間物件之間的時間長短。 起點與終點分別為 this 以及指定的時間點。 如果終點不同，終點會轉換成與起始點相同類型。 如果結束時間在開始之前，結果將為負。 例如，兩個時間物體之間的小時數可用 來計算 startTime.until(endTime, HOURS)。

計算回傳一個整數，代表兩個時間點之間的完整單位數。 例如，11：30 到 13：29 之間的小時數只會是一小時，因為這距離兩小時差一分鐘。

使用此方法有兩種等效方式。 第一種是直接引用此方法。 第二種是使用 TemporalUnit#between(Temporal, Temporal)：

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

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

例如，此方法允許計算兩個日期之間的天數：

long daysBetween = start.until(end, DAYS);
             // or alternatively
             long daysBetween = DAYS.between(start, end);

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

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