Linguaggio

DateTimeFormatter.WithChronology(IChronology) Metodo

Definizione

Restituisce una copia di questo formattatore con una nuova cronologia di override.

[Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithChronology(Java.Time.Chrono.IChronology? chrono);
[<Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithChronology : Java.Time.Chrono.IChronology -> Java.Time.Format.DateTimeFormatter

Parametri

chrono
IChronology

la nuova cronologia, null se non viene eseguito alcun override

Valori restituiti

formattatore basato su questo formattatore con la cronologia di override richiesta, non null

Attributi

Commenti

Restituisce una copia di questo formattatore con una nuova cronologia di override.

Viene restituito un formattatore con uno stato simile a questo formattatore, ma con il set di cronologia di override. Per impostazione predefinita, un formattatore non ha cronologia di override, restituendo null.

Se viene aggiunto un override, verrà interessata qualsiasi data formattata o analizzata.

Durante la formattazione, se l'oggetto temporale contiene una data, verrà convertita in una data nella cronologia di override. Indica se la data temporale è determinata eseguendo una query sul ChronoField#EPOCH_DAY EPOCH_DAY campo. Qualsiasi fuso orario o fuso verrà mantenuto invariato a meno che non venga sottoposto a override.

Se l'oggetto temporale non contiene una data, ma contiene uno o più ChronoField campi di data, viene generata un'eccezione DateTimeException . In tutti gli altri casi, la cronologia di override viene aggiunta alla cronologia temporale, sostituendo qualsiasi cronologia precedente, ma senza modificare la data/ora.

Durante l'analisi, esistono due casi distinti da considerare. Se una cronologia è stata analizzata direttamente dal testo, forse perché DateTimeFormatterBuilder#appendChronologyId() è stata usata, questa cronologia di override non ha alcun effetto. Se non è stata analizzata alcuna zona, questa cronologia di override verrà usata per interpretare i ChronoField valori in una data in base alle regole di risoluzione della data della cronologia.

Questa istanza non è modificabile e non influenzata da questa chiamata al metodo.

per java.time.format.DateTimeFormatter.withChronology(java.time.chrono.Chronology).

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