Язык

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

дата окончания, монопольная, которая преобразуется в ZonedDateTime, а не null

unit
ITemporalUnit

единица измерения суммы, а не null

Возвращаемое значение

время между данным временем и конечным датой

Реализации

Атрибуты

Комментарии

Вычисляет время до другого даты и времени с точки зрения указанной единицы. Это вычисляет время между двумя объектами ZonedDateTime с точки зрения одного ТемпоральногоUnit. Начальные и конечные точки — это и указанное время даты. Результат будет отрицательным, если конец будет до начала. Например, количество в днях между двумя датами можно вычислить с помощью startDateTime.until(endDateTime, DAYS). Темпоральный метод, передаваемый этому методу, преобразуется в ZonedDateTime с помощью (ТемпорКсистор). Если часовой пояс отличается между двумя зонами даты и времени, то указанное время окончания нормализовано для того же пояса, что и это время даты. Вычисление возвращает целое число, представляющее количество полных единиц между двумя датами. Например, сумма в месяцах между 2012-06-15T00:00Z и 2012-08-14T23:59Z будет только один месяц, так как это составляет одну минуту не более двух месяцев. Существует два эквивалентных способа использования этого метода. Первое — вызвать этот метод. Второй — использовать TemporalUnit.between(Темпоральный, Темпоральный): выбор должен быть сделан на основе того, что делает код более читаемым. Вычисление реализуется в этом методе для ChronoUnit. Поддерживаются единицы NANOS, MICROS, МИЛЛИС, СЕКУНДЫ, МИНУТЫ, ЧАСЫ и HALF_DAYS, ДНИ, НЕДЕЛИ, МЕСЯЦЫ, ГОДЫ, ДЕСЯТИЛЕТИЯ, ВЕКА, ТЫСЯЧЕЛЕТИЯ и ЭРА. Другие значения ChronoUnit вызывают исключение. Расчет для единиц даты и времени отличается. Единицы даты работают в локальной строке времени с использованием локальной даты и времени. Например, период от полудня до полудня на следующий день в днях всегда будет считаться ровно одним днем, независимо от того, было ли изменение дневной экономии или нет. Единицы времени работают в мгновенной строке времени. Вычисление эффективно преобразует оба зоны даты и времени в экземпляры, а затем вычисляет период между экземплярами. Например, период от полудня до полудня на следующий день в часах может быть 23, 24 или 25 часов (или другое количество) в зависимости от того, было ли изменение летнего времени. Если единица не является хроноунитом, результат этого метода получается путем вызова TemporalUnit.between(Темпоральный, Темпоральный) передается в качестве первого аргумента и преобразованного входного темпорального в качестве второго аргумента. Этот экземпляр неизменяем и не влияет на этот вызов метода.

Java справочные материалы.java.time.ZonedDateTime.until

Применяется к