OffsetDateTime.With Metodo

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/OffsetDateTime;", "", ApiSince=26)]
public Java.Time.OffsetDateTime? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);

[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/OffsetDateTime;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.OffsetDateTime

Parametri

Valori restituiti

OffsetDateTime basato su questo oggetto con la regolazione effettuata, non null

Attributi

RegisterAttribute

Commenti

Restituisce una copia modificata di questa data e ora. In questo modo viene restituito un valore OffsetDateTime, in base a questo, con la data modificata. La regolazione viene eseguita utilizzando l'oggetto strategia di regolazione specificato. Leggere la documentazione del regolatore per comprendere quali modifiche verranno apportate. Un semplice regolatore potrebbe semplicemente impostare uno dei campi, ad esempio il campo year. Un regolatore più complesso potrebbe impostare la data sull'ultimo giorno del mese. Una selezione di rettifiche comuni viene fornita in TemporalAdjusters. Questi includono la ricerca dell'ultimo giorno del mese e "mercoledì successivo". Le classi di data e ora chiave implementano anche l'interfaccia TemporalAdjuster, ad esempio Month e MonthDay. Il regolatore è responsabile della gestione di casi speciali, ad esempio la lunghezza variabile del mese e gli anni bisestili. Ad esempio, questo codice restituisce una data l'ultimo giorno di luglio: le classi LocalDate, LocalTime e ZoneOffset implementano TemporalAdjuster, pertanto questo metodo può essere utilizzato per modificare la data, l'ora o l'offset: il risultato di questo metodo viene ottenuto richiamando il metodo TemporalAdjuster.adjustInto(Temporal) sul correttore specificato passando questo come argomento. Questa istanza non è modificabile e non influenzata da questa chiamata al metodo.

Java informazioni di riferimento per java.time.OffsetDateTime.with.

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/OffsetDateTime;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? With(Java.Time.Temporal.ITemporalField? field, long newValue);

[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/OffsetDateTime;", "", ApiSince=26)>]
abstract member With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
override this.With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal

Parametri

Valori restituiti

OffsetDateTime basato su questo oggetto con il set di campi specificato, non null

Implementazioni

Attributi

RegisterAttribute

Commenti

Restituisce una copia di questa data e ora con il campo specificato impostato su un nuovo valore. Viene restituito un valore OffsetDateTime, in base a questo, con il valore per il campo specificato modificato. Può essere usato per modificare qualsiasi campo supportato, ad esempio l'anno, il mese o il giorno del mese. Se non è possibile impostare il valore, perché il campo non è supportato o per altri motivi, viene generata un'eccezione. In alcuni casi, la modifica del campo specificato può causare l'invalidità della data risultante, ad esempio la modifica del mese dal 31 gennaio a febbraio renderebbe il giorno del mese non valido. In casi come questo, il campo è responsabile della risoluzione della data. In genere sceglierà la data valida precedente, che sarà l'ultimo giorno valido di febbraio in questo esempio. Se il campo è un ChronoField, la regolazione viene implementata qui. Il campo INSTANT_SECONDS restituirà una data e ora con l'istante specificato. L'offset e il nano-di-secondo sono invariati. Se il nuovo valore istantaneo non è compreso nell'intervallo valido, verrà generata un'eccezione DateTimeException. Il campo OFFSET_SECONDS restituirà una data e ora con l'offset specificato. La data e l'ora locale non vengono modificate. Se il nuovo valore di offset non rientra nell'intervallo valido, verrà generata un'eccezione DateTimeException. Gli altri campi supportati si comportano in base al metodo corrispondente in LocalDateTime. In questo caso, l'offset non fa parte del calcolo e sarà invariato. Tutte le altre istanze di ChronoField genereranno un'eccezione UnsupportedTemporalTypeException. Se il campo non è un ChronoField, il risultato di questo metodo viene ottenuto richiamando TemporalField.adjustInto(Temporal, long) passando questo come argomento. In questo caso, il campo determina se e come regolare l'istante. Questa istanza non è modificabile e non influenzata da questa chiamata al metodo.

Java informazioni di riferimento per java.time.OffsetDateTime.with.