DateTimeFormatter.WithResolverFields 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.
Surcharges
WithResolverFields(ITemporalField[]) | |
WithResolverFields(ICollection<ITemporalField>) |
Retourne une copie de ce formateur avec un nouvel ensemble de champs de programme de résolution. |
WithResolverFields(ITemporalField[])
[Android.Runtime.Register("withResolverFields", "([Ljava/time/temporal/TemporalField;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithResolverFields (params Java.Time.Temporal.ITemporalField[]? resolverFields);
[<Android.Runtime.Register("withResolverFields", "([Ljava/time/temporal/TemporalField;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithResolverFields : Java.Time.Temporal.ITemporalField[] -> Java.Time.Format.DateTimeFormatter
Paramètres
- resolverFields
- ITemporalField[]
Retours
- Attributs
S’applique à
WithResolverFields(ICollection<ITemporalField>)
Retourne une copie de ce formateur avec un nouvel ensemble de champs de programme de résolution.
[Android.Runtime.Register("withResolverFields", "(Ljava/util/Set;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithResolverFields (System.Collections.Generic.ICollection<Java.Time.Temporal.ITemporalField>? resolverFields);
[<Android.Runtime.Register("withResolverFields", "(Ljava/util/Set;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithResolverFields : System.Collections.Generic.ICollection<Java.Time.Temporal.ITemporalField> -> Java.Time.Format.DateTimeFormatter
Paramètres
- resolverFields
- ICollection<ITemporalField>
le nouvel ensemble de champs de programme de résolution, Null si aucun champ n’est
Retours
un formateur basé sur ce formateur avec le style de programme de résolution demandé, et non null
- Attributs
Remarques
Retourne une copie de ce formateur avec un nouvel ensemble de champs de programme de résolution.
Cela retourne un formateur avec un état similaire à ce formateur, mais avec les champs de programme de résolution définis. Par défaut, un formateur n’a pas de champs de programme de résolution.
La modification des champs du programme de résolution n’a qu’un effet lors de l’analyse. L’analyse d’une chaîne de texte se produit en deux phases. La phase 1 est une analyse de texte de base en fonction des champs ajoutés au générateur. La phase 2 résout les paires champ-valeur analysées en objets date et/ou heure. Les champs de programme de résolution sont utilisés pour filtrer les paires champ-valeur entre la phase 1 et 2.
Cela peut être utilisé pour sélectionner entre deux façons ou plus de résoudre une date ou une heure. Par exemple, si le formateur se compose de l’année, du mois, du jour du mois et du jour de l’année, il existe deux façons de résoudre une date. Appel de cette méthode avec les arguments ChronoField#YEAR YEAR
et ChronoField#DAY_OF_YEAR DAY_OF_YEAR
s’assurer que la date est résolue à l’aide de l’année et du jour de l’année, ce qui signifie efficacement que le mois et le jour du mois sont ignorés pendant la phase de résolution.
De la même manière, cette méthode peut être utilisée pour ignorer les champs secondaires qui seraient sinon vérifiés de manière croisée. Par exemple, si le formateur se compose de l’année, du mois, du jour du mois et du jour de la semaine, il n’existe qu’une seule façon de résoudre une date, mais la valeur analysée pour le jour de la semaine est cochée par rapport à la date résolue. Appel de cette méthode avec les arguments ChronoField#YEAR YEAR
et ChronoField#DAY_OF_MONTH DAY_OF_MONTH
ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR
garantit que la date est correctement résolue, mais sans vérification croisée pour le jour de la semaine.
En termes d’implémentation, cette méthode se comporte comme suit. Le résultat de la phase d’analyse peut être considéré comme une carte de champ à valeur. Le comportement de cette méthode consiste à filtrer cette carte entre la phase 1 et 2, en supprimant tous les champs autres que ceux spécifiés comme arguments de cette méthode.
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.