ITemporalUnit.AddTo(Object, Int64) Метод

Определение

Пространство имен:: Java.Time.Temporal

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает копию указанного темпорального объекта с указанным периодом, добавленным.

[Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
[Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })]
public Java.Lang.Object? AddTo(Java.Lang.Object? temporal, long amount);

[<Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member AddTo : Java.Lang.Object * int64 -> Java.Lang.Object

Параметры

temporal: Object

темпоральный объект для корректировки, а не null

amount: Int64

объем этого урока для добавления, положительного или отрицательного

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

Object

скорректированный темпоральный объект, а не null

Атрибуты: RegisterAttribute JavaTypeParametersAttribute

Добавленный период является нескольким из этого урока. Например, этот метод можно использовать для добавления "3 дня" в дату путем вызова этого метода в экземпляре, представляющего "days", передав дату и период "3". Добавляемый период может быть отрицательным, что эквивалентно вычитании.

Существует два эквивалентных способа использования этого метода. Первое — вызвать этот метод напрямую. Второй — использовать Temporal#plus(long, TemporalUnit):

// these two lines are equivalent, but the second approach is recommended
              temporal = thisUnit.addTo(temporal);
              temporal = temporal.plus(thisUnit);

Рекомендуется использовать второй подход, plus(TemporalUnit)так как это гораздо более ясно для чтения в коде.

Реализации должны выполнять любые запросы или вычисления с помощью единиц, доступных в ChronoUnit или доступных ChronoFieldв полях. Если единица не поддерживается UnsupportedTemporalTypeException , необходимо бросить.

Реализации не должны изменять указанный темпоральный объект. Вместо этого необходимо вернуть скорректированную копию исходного. Это обеспечивает эквивалентное, безопасное поведение для неизменяемых и изменяемых реализаций.

Java документации по java.time.temporal.TemporalUnit.addTo(R, long).

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

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