语言

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

结束时间,独占,转换为 OffsetTime,而不是 null

unit
ITemporalUnit

度量量单位,而不是 null

返回

此时间与结束时间之间的时间量

实现

特性

注解

计算指定单位中其他时间之前的时间量。 这将根据单个 TemporalUnit 计算两个 OffsetTime 对象之间的时间量。 起点和终点是此值和指定时间。 如果结束在开始之前,结果将为负。 例如,可以使用 startTime.until(endTime,HOURS)计算两次之间的小时数。 传递给此方法的时态将转换为 OffsetTime(TemporalAccessor)。 如果两次之间的偏移量不同,则指定的结束时间将规范化为与这次相同的偏移量。 计算返回一个整数,表示两次之间的完整单位数。 例如,介于 11:30Z 和 13:29Z 之间的小时数仅为 1 小时,因为它在两小时短一分钟。 使用此方法有两种等效的方法。 第一种方法是调用此方法。 第二种是使用 TemporalUnit.between(Temporal,Temporal):

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

应根据该选项使代码更具可读性。 计算是在 ChronoUnit 的此方法中实现的。 支持 NANOS、MICROS、MILLIS、SECONDS、MINUTES、HOURS 和 HALF_DAYS 单位。 其他 ChronoUnit 值将引发异常。 如果单位不是 ChronoUnit,则通过调用 TemporalUnit.between(Temporal, Temporal) 将此方法的结果作为第一个参数传递,并将转换后的输入时态作为第二个参数获得。 此实例不可变,不受此方法调用影响。

Java参考java.time.OffsetTime.until。

适用于