DateTimeFormatter.WithZone(ZoneId) Méthode

[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.DateTimeFormatter

Paramètres

Retours

un formateur basé sur ce formateur avec la zone de remplacement demandée, et non null

Attributs

RegisterAttribute

Remarques

Retourne une copie de ce formateur avec une nouvelle zone de remplacement.

Cela retourne un formateur avec un état similaire à ce formateur, mais avec le jeu de zones de remplacement. Par défaut, un formateur n’a pas de zone de remplacement, retournant null.

Si une substitution est ajoutée, tout instant mis en forme ou analysé est affecté.

Lors de la mise en forme, si l’objet temporel contient un instant, il est converti en date-heure interzone à l’aide de la zone de remplacement. Indique si le temps est un instant déterminé en interrogeant le ChronoField#INSTANT_SECONDS INSTANT_SECONDS champ. Si l’entrée a une chronologie, elle est conservée, sauf substitution. Si l’entrée n’a pas de chronologie, par Instantexemple, la chronologie ISO sera utilisée.

Si l’objet temporel ne contient pas d’instant, mais qu’il contient un décalage, une vérification supplémentaire est effectuée. Si la zone de remplacement normalisée est un décalage qui diffère de l’offset du temporel, une DateTimeException valeur est levée. Dans tous les autres cas, la zone de remplacement est ajoutée au temps, en remplaçant n’importe quelle zone précédente, mais sans modifier la date/heure.

Lors de l’analyse, il existe deux cas distincts à prendre en compte. Si une zone a été analysée directement à partir du texte, peut-être parce qu’elle DateTimeFormatterBuilder#appendZoneId() a été utilisée, cette zone de remplacement n’a aucun effet. Si aucune zone n’a été analysée, cette zone de remplacement est incluse dans le résultat de l’analyse où elle peut être utilisée pour générer des instants et des dates.

Cette instance est immuable et non affectée par cet appel de méthode.

Documentation Java pour java.time.format.DateTimeFormatter.withZone(java.time.ZoneId).

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.

S’applique à