Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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