ZonedDateTime.Until(ITemporal, ITemporalUnit) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
根据指定的单位计算另一个日期时间之前的时间量。
[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
结束日期,独占,转换为 ZonedDateTime,而不是 null
- unit
- ITemporalUnit
度量量单位,而不是 null
返回
此日期时间与结束日期时间之间的时间量
实现
- 特性
注解
根据指定的单位计算另一个日期时间之前的时间量。 这将根据单个 TemporalUnit 计算两个 ZonedDateTime 对象之间的时间量。 起点和终点是此点和指定的日期时间。 如果结束在开始之前,结果将为负。 例如,可以使用 startDateTime.until(endDateTime,DAYS)计算两个日期/时间之间的天数。 传递给此方法的时态将转换为使用 From(TemporalAccessor)的 ZonedDateTime。 如果时区在这两个区域日期时间之间不同,则指定的结束日期时间将规范化为与此日期时间相同的区域。 计算返回一个整数,表示两个日期时间之间的完整单位数。 例如,2012-06-15T00:00Z 和 2012-08-14T23:59Z 之间的月份金额仅为一个月,因为两个月内只有一分钟。 使用此方法有两种等效的方法。 第一种方法是调用此方法。 第二种是使用 TemporalUnit.between(Temporal,Temporal):
// these two lines are equivalent
amount = start.until(end, MONTHS);
amount = MONTHS.between(start, end);
应根据该选项使代码更具可读性。 计算是在 ChronoUnit 的此方法中实现的。 支持 NANOS、MICROS、MILLIS、秒、分钟、小时和HALF_DAYS、天、周、月、年、几十、世纪、千年和 ERAS 的单位。 其他 ChronoUnit 值将引发异常。 日期和时间单位的计算有所不同。 日期单位使用本地日期-时间在本地时间行上运行。 例如,从第 1 天中午到第二天中午的时间段将始终算作一天,而不管是否发生夏令时制更改。 时间单位在即时时间线上运行。 计算有效地将两个分区日期时间转换为即时,然后计算实例之间的时间段。 例如,从第 1 天中午到第二天中午的时间段(以小时为单位)可以是 23、24 或 25 小时(或其他一些金额),具体取决于夏令时制是否发生了变化。 如果单位不是 ChronoUnit,则通过调用 TemporalUnit.between(Temporal, Temporal) 将此方法的结果作为第一个参数传递,并将转换后的输入时态作为第二个参数获得。 此实例不可变,不受此方法调用影响。
Java参考java.time.ZonedDateTime.until。