语言

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

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

unit
ITemporalUnit

度量量单位,而不是 null

返回

本月与年底之间的时间

实现

特性

注解

根据指定的单位计算一年到另一年的时间。 这将根据单个 TemporalUnit 计算两个 YearMonth 对象之间的时间量。 起点和终点是此点和指定的年月。 如果结束在开始之前,结果将为负。 传递给此方法的时态值使用 (TemporalAccessor) 转换为 YearMonth。 例如,可以使用 startYearMonth.until(endYearMonth,YEARS)计算两年之间的年数。 计算返回一个整数,表示两年之间的完整单位数。 例如,2012-06 年至 2032-05 之间的几十年量将仅为 10 年,因为它比 20 年短一个月。 使用此方法有两种等效的方法。 第一种方法是调用此方法。 第二种是使用 TemporalUnit.between(Temporal,Temporal):

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

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

Java参考java.time.YearMonth.until。

适用于