ITemporalField.AdjustInto(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 valore di questo set di campi.

[Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAdjustInto_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalFieldInvoker, 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? AdjustInto(Java.Lang.Object? temporal, long newValue);

[<Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAdjustInto_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalFieldInvoker, 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 AdjustInto : Java.Lang.Object * int64 -> Java.Lang.Object

Parametri

temporal: Object

oggetto temporale da regolare, non null

newValue: Int64

nuovo valore del campo

Valori restituiti

Object

oggetto temporale regolato, non Null

Attributi: RegisterAttribute JavaTypeParametersAttribute

Commenti

Restituisce una copia dell'oggetto temporale specificato con il valore di questo set di campi.

Verrà restituito un nuovo oggetto temporale in base a quello specificato con il valore per questo campo modificato. Ad esempio, in un LocalDateoggetto , può essere usato per impostare l'anno, il mese o il giorno del mese. L'oggetto restituito ha lo stesso tipo osservabile dell'oggetto specificato.

In alcuni casi, la modifica di un campo non è completamente definita. Ad esempio, se l'oggetto di destinazione è una data che rappresenta il 31 gennaio, la modifica del mese in febbraio non sarà chiara. In casi come questo, l'implementazione è responsabile della risoluzione del risultato. In genere sceglierà la data valida precedente, che sarà l'ultimo giorno valido di febbraio in questo esempio.

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

// these two lines are equivalent, but the second approach is recommended
              temporal = thisField.adjustInto(temporal);
              temporal = temporal.with(thisField);

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

Le implementazioni devono eseguire query o calcoli usando i campi disponibili in ChronoField. Se il campo non è supportato, è 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.TemporalField.adjustInto(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