DateTimeFormatter.WithChronology(IChronology) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une copie de ce formateur avec une nouvelle chronologie de remplacement.
[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.DateTimeFormatterParamètres
- chrono
- IChronology
la nouvelle chronologie, null si aucune substitution n’est remplacée
Retours
un formateur basé sur ce formateur avec la chronologie de remplacement demandée, et non null
- Attributs
Remarques
Retourne une copie de ce formateur avec une nouvelle chronologie de remplacement.
Cela retourne un formateur avec un état similaire à ce formateur, mais avec le jeu de chronologies de remplacement. Par défaut, un formateur n’a pas de chronologie de remplacement, retournant null.
Si une substitution est ajoutée, toute date mise en forme ou analysée est affectée.
Lors de la mise en forme, si l’objet temporel contient une date, il est converti en date dans la chronologie de remplacement. Indique si le temps contient une date est déterminée en interrogeant le ChronoField#EPOCH_DAY EPOCH_DAY champ. Toute heure ou fuseau horaire est conservée sans modification, sauf substitution.
Si l’objet temporel ne contient pas de date, mais qu’il contient un ou plusieurs ChronoField champs de date, un DateTimeException objet est levée. Dans tous les autres cas, la chronologie de remplacement est ajoutée à la chronologie temporelle, en remplaçant toute chronologie précédente, mais sans modifier la date/heure.
Lors de l’analyse, il existe deux cas distincts à prendre en compte. Si une chronologie a été analysée directement à partir du texte, peut-être parce qu’elle DateTimeFormatterBuilder#appendChronologyId() a été utilisée, cette chronologie de remplacement n’a aucun effet. Si aucune zone n’a été analysée, cette chronologie de remplacement sera utilisée pour interpréter les ChronoField valeurs dans une date en fonction des règles de résolution de date de la chronologie.
Cette instance est immuable et non affectée par cet appel de méthode.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.