ITemporalUnit.AddTo(Object, Int64) Método

Definición

Espacio de nombres:: Java.Time.Temporal

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Devuelve una copia del objeto temporal especificado con el período especificado agregado.

[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

Parámetros

temporal: Object

el objeto temporal que se va a ajustar, no null

amount: Int64

la cantidad de esta unidad que se va a agregar, positiva o negativa.

Devoluciones

Object

el objeto temporal ajustado, no null

Atributos: RegisterAttribute JavaTypeParametersAttribute

Comentarios

Devuelve una copia del objeto temporal especificado con el período especificado agregado.

El período agregado es un múltiplo de esta unidad. Por ejemplo, este método podría usarse para agregar "3 días" a una fecha llamando a este método en la instancia que representa "días", pasando la fecha y el punto "3". El período que se va a agregar puede ser negativo, que es equivalente a la resta.

Hay dos formas equivalentes de usar este método. La primera consiste en invocar directamente este método. El segundo es usar Temporal#plus(long, TemporalUnit):

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

Se recomienda usar el segundo enfoque, , plus(TemporalUnit)ya que es mucho más claro leer en el código.

Las implementaciones deben realizar consultas o cálculos mediante las unidades disponibles en ChronoUnit o los campos disponibles en ChronoField. Si no se admite UnsupportedTemporalTypeException la unidad, debe iniciarse .

Las implementaciones no deben modificar el objeto temporal especificado. En su lugar, se debe devolver una copia ajustada del original. Esto proporciona un comportamiento equivalente y seguro para implementaciones inmutables y mutables.

Java documentación para java.time.temporal.TemporalUnit.addTo(R, long).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a