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

CKTIS / Java

DateTimeFormatter : motifs, paramètres régionaux et analyse stricte

Choisissez un motif et des paramètres régionaux pour le texte, puis un mode de résolution pour la validation de la date. Distinguez `MM` de `mm` et `uuuu` de `yyyy`.

Version : Java SE 21

Syntaxe

java.time.format.DateTimeFormatter (Java SE 21)
static DateTimeFormatter ofPattern(String pattern)
static DateTimeFormatter ofPattern(String pattern, Locale locale)
DateTimeFormatter withLocale(Locale locale)
DateTimeFormatter withResolverStyle(ResolverStyle resolverStyle)

Locale: java.util.Locale
ResolverStyle: java.time.format.ResolverStyle

La méthode statique DateTimeFormatter.ofPattern crée un formateur à partir d’un motif. La surcharge ofPattern(String) utilise les paramètres régionaux par défaut de la catégorie FORMAT, tandis que ofPattern(String, Locale) utilise ceux fournis explicitement. Toutes deux utilisent initialement SMART. Un motif invalide provoque une IllegalArgumentException dès la création du formateur.

La casse compte : dd indique le jour du mois, MM le mois numérique et mm les minutes. Les motifs dd-MM-uuuu, dd/MM/uuuu et uuuu-MM-dd fixent l’ordre des champs et les séparateurs. uuuu désigne l’année proleptique (avec une année zéro), et yyyy l’année de l’ère. En analyse ISO stricte, yyyy accompagné du seul mois et du seul jour ne suffit pas pour obtenir une LocalDate, car aucune ère n’est supposée. Utilisez uuuu pour les dates sans ère.

DateTimeFormatter.withLocale définit la Locale du formateur renvoyé. Elle influe sur le texte, par exemple les noms complets des mois (MMMM), à la mise en forme comme à l’analyse, mais ne modifie ni l’ordre des champs ni les séparateurs d’un motif explicite. Les formateurs sont immuables et utilisables par plusieurs threads : conservez la valeur renvoyée par withLocale ou withResolverStyle, car l’original reste intact.

DateTimeFormatter.withResolverStyle pilote la deuxième phase de l’analyse : après lecture des champs selon le motif, le formateur les résout en une date. La mise en forme ne change pas. Pour les dates ISO, STRICT rejette les dates impossibles, SMART peut ramener un jour compris entre 1 et 31 au dernier jour du mois, et LENIENT peut reporter les jours excédentaires sur le mois suivant. LocalDate.parse(text, formatter) lève une DateTimeParseException si le texte ne correspond pas au motif ou ne permet pas d’obtenir une date.

Exemples

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2024, 1, 5);
        DateTimeFormatter english = DateTimeFormatter.ofPattern("dd MMMM uuuu", Locale.US);
        DateTimeFormatter french = english.withLocale(Locale.FRANCE);
        System.out.println(date.format(english));
        System.out.println(date.format(french));

        DateTimeFormatter smart = DateTimeFormatter.ofPattern("dd-MM-uuuu", Locale.ROOT);
        DateTimeFormatter strict = smart.withResolverStyle(ResolverStyle.STRICT);
        String invalid = "31-02-2024";
        System.out.println("SMART: " + LocalDate.parse(invalid, smart));
        try {
            System.out.println("STRICT: " + LocalDate.parse(invalid, strict));
        } catch (DateTimeParseException e) {
            System.out.println("STRICT: rejected");
        }
    }
}

Résultat

05 January 2024
05 janvier 2024
SMART: 2024-02-29
STRICT: rejected

Les paramètres régionaux changent le nom du mois, pas la structure de la date. Les noms dépendent des données de localisation de l’environnement d’exécution. Pour `31-02-2024`, `SMART` renvoie `2024-02-29`, tandis que `STRICT` rejette l’entrée.

Leçons associées

  • Java · Leçon 61 · Avancé · Version : 2

Sources