语言

LocalDate.Until 方法

定义

重载

名称 说明
Until(IChronoLocalDate)

计算此日期与另一个日期之间的周期作为句点。

Until(ITemporal, ITemporalUnit)

计算指定单位中另一个日期之前的时间量。

Until(IChronoLocalDate)

计算此日期与另一个日期之间的周期作为句点。

[Android.Runtime.Register("until", "(Ljava/time/chrono/ChronoLocalDate;)Ljava/time/Period;", "", ApiSince=26)]
public Java.Time.Chrono.IChronoPeriod? Until(Java.Time.Chrono.IChronoLocalDate? endDateExclusive);
[<Android.Runtime.Register("until", "(Ljava/time/chrono/ChronoLocalDate;)Ljava/time/Period;", "", ApiSince=26)>]
abstract member Until : Java.Time.Chrono.IChronoLocalDate -> Java.Time.Chrono.IChronoPeriod
override this.Until : Java.Time.Chrono.IChronoLocalDate -> Java.Time.Chrono.IChronoPeriod

参数

endDateExclusive
IChronoLocalDate

结束日期,独占,它可以在任何时间表,而不是 null

返回

此日期与结束日期之间的时间段,而不是 null

实现

特性

注解

计算此日期与另一个日期之间的周期作为句点。 这将计算两个日期之间的期限,以年、月和日为单位。 起点和终点是此日期和指定日期。 如果结束在开始之前,结果将为负。 负号将在每年、月和日中相同。 计算是使用 ISO 日历系统执行的。 如有必要,输入日期将转换为 ISO。 开始日期包括,但结束日期不是。 通过删除完整的月份来计算此时间段,然后计算剩余天数,进行调整以确保两者具有相同的符号。 然后,根据 12 个月的年份将月份规范化为年份和月份。 如果一个月的结束日期大于或等于当月开始日,则一个月被视为完成。 例如,从 2010-01-15 到 2011-03-18 是“1 年、2 个月和 3 天”。 使用此方法有两种等效的方法。 第一种方法是调用此方法。 第二种是使用 Period.between(LocalDate,LocalDate):

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

应根据该选项使代码更具可读性。

Java参考java.time.LocalDate.until。

适用于

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

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

unit
ITemporalUnit

度量量单位,而不是 null

返回

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

实现

特性

注解

计算指定单位中另一个日期之前的时间量。 这将根据单个 TemporalUnit 计算两个 LocalDate 对象之间的时间量。 起点和终点是此日期和指定日期。 如果结束在开始之前,结果将为负。 传递给此方法的临时值使用 From(TemporalAccessor)转换为 LocalDate。 例如,可以使用 startDate.until(endDate,DAYS)计算两个日期之间的天数。 计算返回一个整数,表示两个日期之间的完整单位数。 例如,2012-06-15 和 2012-08-14 之间的月数将仅为一个月,因为它在两个月内只有一天。 使用此方法有两种等效的方法。 第一种方法是调用此方法。 第二种是使用 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.LocalDate.until。

适用于