Share via

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

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.

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