ITemporalUnit.AddTo(Object, Int64) Metodo

Definizione

Spazio dei nomi:: Java.Time.Temporal

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Restituisce una copia dell'oggetto temporale specificato con il periodo specificato aggiunto.

[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

Parametri

temporal: Object

oggetto temporale da regolare, non null

amount: Int64

quantità di questa unità da aggiungere, positivo o negativo

Valori restituiti

Object

oggetto temporale regolato, non Null

Attributi: RegisterAttribute JavaTypeParametersAttribute

Commenti

Restituisce una copia dell'oggetto temporale specificato con il periodo specificato aggiunto.

Il periodo aggiunto è un multiplo di questa unità. Ad esempio, questo metodo può essere usato per aggiungere "3 giorni" a una data chiamando questo metodo nell'istanza che rappresenta "days", passando la data e il periodo "3". Il periodo da aggiungere può essere negativo, che equivale alla sottrazione.

Esistono due modi equivalenti per usare questo metodo. Il primo consiste nel richiamare direttamente questo metodo. Il secondo consiste nell'usare Temporal#plus(long, TemporalUnit):

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

È consigliabile usare il secondo approccio, , plus(TemporalUnit)perché è molto più chiaro leggere nel codice.

Le implementazioni devono eseguire query o calcoli usando le unità disponibili in ChronoUnit o i campi disponibili in ChronoField. Se l'unità non è supportata, è necessario generare un'eccezione UnsupportedTemporalTypeException .

Le implementazioni non devono modificare l'oggetto temporale specificato. È invece necessario restituire una copia modificata dell'originale. In questo modo è disponibile un comportamento equivalente e sicuro per le implementazioni non modificabili e non modificabili.

per java.time.temporal.TemporalUnit.addTo(R, long).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a