DateTimeFormatter.WithZone(ZoneId) Metodo
Definizione
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 di questo formattatore con una nuova zona di override.
[Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithZone (Java.Time.ZoneId? zone);[<Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithZone : Java.Time.ZoneId -> Java.Time.Format.DateTimeFormatterParametri
- zone
- ZoneId
la nuova zona di override, null se non viene eseguito alcun override
Restituisce
formattatore basato su questo formattatore con la zona di override richiesta, non null
- Attributi
Commenti
Restituisce una copia di questo formattatore con una nuova zona di override.
Viene restituito un formattatore con stato simile a questo formattatore, ma con il set di zone di override. Per impostazione predefinita, un formattatore non ha una zona di override, restituendo null.
Se viene aggiunto un override, verrà interessato qualsiasi istante formattato o analizzato.
Quando si formatta, se l'oggetto temporale contiene un istante, verrà convertito in un'ora di data e ora con zone usando la zona di override. Indica se il valore temporale è un istante determinato eseguendo una query sul ChronoField#INSTANT_SECONDS INSTANT_SECONDS campo. Se l'input ha una cronologia, verrà conservato a meno che non venga sottoposto a override. Se l'input non ha una cronologia, ad esempio Instant, verrà usata la cronologia ISO.
Se l'oggetto temporale non contiene un istante, ma contiene un offset, viene effettuato un controllo aggiuntivo. Se la zona di override normalizzata è un offset diverso dall'offset temporale, viene generata un'eccezione DateTimeException . In tutti gli altri casi, la zona di override viene aggiunta alla zona temporale, sostituendo qualsiasi zona precedente, ma senza modificare la data/ora.
Durante l'analisi, esistono due casi distinti da considerare. Se una zona è stata analizzata direttamente dal testo, forse perché DateTimeFormatterBuilder#appendZoneId() è stata usata, questa zona di override non ha alcun effetto. Se non è stata analizzata alcuna zona, questa zona di override verrà inclusa nel risultato dell'analisi in cui può essere usata per creare istantanee e date-time.
Questa istanza non è modificabile e non influenzata da questa chiamata al metodo.
Documentazione java per java.time.format.DateTimeFormatter.withZone(java.time.ZoneId).
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.