LocalDate.Until 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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。