语言

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

结束日期,独占,转换为年份,而不是 null

unit
ITemporalUnit

度量量单位,而不是 null

返回

今年到年底之间的时间量

实现

特性

注解

根据指定的单位计算一年之前的时间量。 这将根据单个 TemporalUnit 计算两个 Year 对象之间的时间量。 起点和终点是此年份和指定年份。 如果结束在开始之前,结果将为负。 传递给此方法的临时值使用 转换为 Year(TemporalAccessor)。 例如,可以使用 startYear.until(endYear,DECADES)计算 2 年之间的几十年量。 计算返回整数,表示两年之间的完整单位数。 例如,2012 年至 2031 年间的几十年内的金额将仅为 10 年,因为它比 20 年短一年。 使用此方法有两种等效的方法。 第一种方法是调用此方法。 第二种是使用 TemporalUnit.between(Temporal,Temporal):应基于该选项使代码更具可读性。 计算是在 ChronoUnit 的此方法中实现的。 支持年、几十年、几个世纪、千年和 ERAS 的单位。 其他 ChronoUnit 值将引发异常。 如果单位不是 ChronoUnit,则通过调用 TemporalUnit.between(Temporal, Temporal) 将此方法的结果作为第一个参数传递,并将转换后的输入时态作为第二个参数获得。 此实例不可变,不受此方法调用影响。

Java参考java.time.Year.until。

适用于