Lingua

LocalDate.With Metodo

Definizione

Overload

Nome Descrizione
With(ITemporalAdjuster)

Restituisce una copia modificata di questa data.

With(ITemporalField, Int64)

Restituisce una copia di questa data con il campo specificato impostato su un nuovo valore.

With(ITemporalAdjuster)

Restituisce una copia modificata di questa data.

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

Parametri

adjuster
ITemporalAdjuster

regola per l'uso, non null

Valori restituiti

LocalDate in base a questo oggetto con la regolazione effettuata, non null

Attributi

Commenti

Restituisce una copia modificata di questa data. Viene restituito un valore LocalDate, 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:

import static java.time.Month.*;
import static java.time.temporal.TemporalAdjusters.*;

result = localDate.with(JULY).with(lastDayOfMonth());

Il risultato di questo metodo viene ottenuto richiamando il metodo TemporalAdjuster.adjustInto(Temporal) sul regolatore specificato passando questo come argomento. Questa istanza non è modificabile e non influenzata da questa chiamata al metodo.

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

Si applica a

With(ITemporalField, Int64)

Restituisce una copia di questa data con il campo specificato impostato su un nuovo valore.

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/LocalDate;", "", 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/LocalDate;", "", 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

field
ITemporalField

il campo da impostare nel risultato, non null

newValue
Int64

nuovo valore del campo nel risultato

Valori restituiti

LocalDate in base a questo oggetto con il set di campi specificato, non null

Implementazioni

Attributi

Commenti

Restituisce una copia di questa data con il campo specificato impostato su un nuovo valore. Verrà restituito un valore LocalDate, 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. I campi supportati si comportano nel modo seguente: DAY_OF_WEEK - Restituisce localDate con il giorno della settimana specificato. La data viene modificata fino a 6 giorni avanti o indietro entro il limite di una settimana da lunedì a domenica; ALIGNED_DAY_OF_WEEK_IN_MONTH: restituisce un valore LocalDate con l'oggetto aligned-day-of-week specificato. La data viene modificata in base al mese specificato allineato al giorno della settimana specificato. Le settimane allineate vengono conteggiate in modo che la prima settimana di un determinato mese inizi il primo giorno del mese. Ciò può causare lo spostamento della data fino a 6 giorni nel mese successivo; ALIGNED_DAY_OF_WEEK_IN_YEAR: restituisce un valore LocalDate con l'oggetto aligned-day-of-week specificato. La data viene modificata in base all'allineamento basato sull'anno specificato giorno della settimana. Le settimane allineate vengono conteggiate in modo che la prima settimana di un determinato anno inizi il primo giorno dell'anno. Questo può causare lo spostamento della data fino a 6 giorni nell'anno successivo; DAY_OF_MONTH: restituisce un valore LocalDate con il giorno del mese specificato. Il mese e l'anno saranno invariati. Se il giorno del mese non è valido per l'anno e il mese, viene generata un'eccezione DateTimeException; DAY_OF_YEAR: restituisce un valore LocalDate con il giorno dell'anno specificato. L'anno sarà invariato. Se il giorno dell'anno non è valido per l'anno, viene generata un'eccezione DateTimeException; EPOCH_DAY: restituisce un valore LocalDate con il periodo specificato. Questo sostituisce completamente la data ed è equivalente a ofEpochDay(long); ALIGNED_WEEK_OF_MONTH: restituisce un valore LocalDate con l'oggetto aligned-week-of-month specificato. Le settimane allineate vengono conteggiate in modo che la prima settimana di un determinato mese inizi il primo giorno del mese. Questa regolazione sposta la data in blocchi di settimana interi in modo che corrispondano alla settimana specificata. Il risultato avrà lo stesso giorno della settimana di questa data. Ciò può causare lo spostamento della data nel mese successivo; ALIGNED_WEEK_OF_YEAR: restituisce un valore LocalDate con l'oggetto aligned-week-of-year specificato. Le settimane allineate vengono conteggiate in modo che la prima settimana di un determinato anno inizi il primo giorno dell'anno. Questa regolazione sposta la data in blocchi di settimana interi in modo che corrispondano alla settimana specificata. Il risultato avrà lo stesso giorno della settimana di questa data. Ciò può causare lo spostamento della data nell'anno successivo; MONTH_OF_YEAR: restituisce un valore LocalDate con il mese di anno specificato. L'anno sarà invariato. Anche il giorno del mese sarà invariato, a meno che non sia valido per il nuovo mese e l'anno. In tal caso, il giorno del mese viene regolato in base al valore massimo valido per il nuovo mese e l'anno; PROLEPTIC_MONTH: restituisce un valore LocalDate con il mese proptico specificato. Il giorno del mese sarà invariato, a meno che non sia valido per il nuovo mese e l'anno. In tal caso, il giorno del mese viene regolato in base al valore massimo valido per il nuovo mese e l'anno; YEAR_OF_ERA : restituisce un valore LocalDate con l'anno di era specificato. L'era e il mese saranno invariati. Anche il giorno del mese sarà invariato, a meno che non sia valido per il nuovo mese e l'anno. In tal caso, il giorno del mese viene regolato in base al valore massimo valido per il nuovo mese e l'anno; YEAR: restituisce un oggetto LocalDate con l'anno specificato. Il mese sarà invariato. Anche il giorno del mese sarà invariato, a meno che non sia valido per il nuovo mese e l'anno. In tal caso, il giorno del mese viene regolato in base al valore massimo valido per il nuovo mese e l'anno; ERA: restituisce un oggetto LocalDate con l'era specificata. L'anno di era e il mese saranno invariati. Anche il giorno del mese sarà invariato, a meno che non sia valido per il nuovo mese e l'anno. In tal caso, il giorno del mese viene regolato in base al valore massimo valido per il nuovo mese e l'anno. In tutti i casi, se il nuovo valore non rientra nell'intervallo valido di valori per il campo, verrà generata un'eccezione DateTimeException. 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.LocalDate.with.

Si applica a