Year.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
дата окончания, эксклюзивная, которая преобразуется в год, а не null
- unit
- ITemporalUnit
единица измерения суммы, а не null
Возвращаемое значение
Время между этим годом и конечным годом
Реализации
- Атрибуты
Комментарии
Вычисляет время до другого года с точки зрения указанного единицы. Это вычисляет время между двумя объектами Year с точки зрения одного ТемпоральногоUnit. Начальные и конечные точки — это и указанный год. Результат будет отрицательным, если конец будет до начала. Темпоральный, переданный этому методу, преобразуется в year using from(TemporalAccessor). Например, сумма в течение десятилетий между двумя годами можно вычислить с помощью startYear.until(endYear, DECADES). Вычисление возвращает целое число, представляющее количество полных единиц в течение двух лет. Например, сумма в течение десятилетий в период с 2012 по 2031 год будет составлять только одно десятилетие, так как она составляет один год не более двух десятилетий. Существует два эквивалентных способа использования этого метода. Первое — вызвать этот метод. Второй — использовать TemporalUnit.between(Темпоральный, Темпоральный): выбор должен быть сделан на основе того, что делает код более читаемым. Вычисление реализуется в этом методе для ChronoUnit. Поддерживаются единицы "ГОДЫ", "ДЕСЯТИЛЕТИЯ", "ВЕКА", "ТЫСЯЧЕЛЕТИЕ" и "ЭРА". Другие значения ChronoUnit вызывают исключение. Если единица не является хроноунитом, результат этого метода получается путем вызова TemporalUnit.between(Темпоральный, Темпоральный) передается в качестве первого аргумента и преобразованного входного темпорального в качестве второго аргумента. Этот экземпляр неизменяем и не влияет на этот вызов метода.
Java справочные материалы.java.time.Year.until