CKTIS / Java
DateTimeFormatter.ofPattern : un motif de date et d’heure avec Locale.ENGLISH
Créez un formateur pour `yyyy-MM-dd HH:mm z` en indiquant explicitement `Locale.ENGLISH` et découvrez d’où vient le fuseau horaire affiché.
Version : Java SE 21
Syntaxe
import java.time.format.DateTimeFormatter;
import java.util.Locale;
DateTimeFormatter.ofPattern(String pattern)
DateTimeFormatter.ofPattern(String pattern, Locale locale)
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z", Locale.ENGLISH)La méthode statique DateTimeFormatter.ofPattern du paquetage java.time.format crée un formateur immuable, utilisable par plusieurs threads et réutilisable pour le formatage et l’analyse de texte. ofPattern(String) prend les paramètres régionaux par défaut de Locale.Category.FORMAT ; ofPattern(String, Locale) utilise ceux que vous passez, par exemple Locale.ENGLISH. Les deux surcharges lèvent une IllegalArgumentException dès la création si le motif est invalide. Lors de l’analyse, elles utilisent par défaut le mode de résolution SMART.
Les lettres du motif sont sensibles à la casse. Dans yyyy-MM-dd HH:mm z, yyyy désigne l’année dans l’ère, sur au moins quatre chiffres. MM et dd désignent le mois et le jour du mois ; HH et mm, l’heure (00–23) et les minutes. Ces quatre champs sont complétés par un zéro initial si nécessaire pour occuper deux chiffres. uuuu désigne plutôt l’année proleptique, qui admet une année 0.
Au formatage, un seul z affiche le nom court du fuseau et tient compte de l’heure d’été s’il est possible de déterminer qu’elle s’applique ou non. Locale.ENGLISH choisit la langue de ce texte, pas le fuseau. Aucune surcharge n’impose de fuseau : un ZonedDateTime le fournit, mais un LocalDateTime seul ne suffit pas. Les noms des fuseaux régionaux peuvent varier selon les données linguistiques de l’environnement Java et ne sont pas forcément uniques. Avec un ZoneOffset fixe, z affiche l’identifiant du décalage plutôt qu’un nom.
Exemples
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.util.Locale;
public class Main {
public static void main(String[] args) {
DateTimeFormatter formatter =
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z", Locale.ENGLISH);
ZonedDateTime dateTime =
ZonedDateTime.of(2024, 2, 9, 7, 5, 0, 0, ZoneOffset.ofHours(2));
System.out.println(formatter.format(dateTime));
}
}
Résultat
2024-02-09 07:05 +02:00
La sortie `2024-02-09 07:05 +02:00` provient d’une date, d’une heure et d’un décalage fixe explicitement indiqués. `+02:00` est l’identifiant du décalage, et non un nom de fuseau en anglais. L’exemple n’utilise ni l’horloge système, ni le fuseau ou les paramètres régionaux par défaut.
Leçons associées
- Java · Leçon 59 · Intermédiaire · Version : 2
Sources
- DateTimeFormatter (Java SE 21 & JDK 21) — overloads, pattern letters, and resolver style
- DateTimeFormatterBuilder (Java SE 21 & JDK 21) — formatting and parsing zone text
- ZonedDateTime (Java SE 21 & JDK 21) — constructing a zoned date-time
- ZoneOffset (Java SE 21 & JDK 21) — offset ID
- LocaleServiceProvider (Java SE 21 & JDK 21) — locale data providers