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

CKTIS / Java

ResolverStyle — résolution stricte des dates

ResolverStyle contrôle la manière dont les champs analysés sont assemblés en une date ou une heure. Le comportement de ResolverStyle.STRICT dépend des champs : pour une date calendaire ISO donnée par son année, son mois et son jour, ce style rejette le 29 février d’une année non bissextile.

Version : Java SE 21 (documentation scope); repository and production runtimes not attested

Syntaxe

DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

ResolverStyle est un type enum de java.time.format. L’analyse lit d’abord les champs dans le texte, puis les combine en une date ou une heure. Le style contrôle cette seconde étape, et non la correspondance initiale du texte avec un motif ni le formatage du résultat.

Lors de la résolution d’une date calendaire ISO à partir de l’année, du mois et du jour, ResolverStyle.STRICT exige que le jour existe dans le mois et l’année indiqués. Pour ces mêmes champs, ResolverStyle.SMART peut remplacer un numéro de jour trop élevé par le dernier jour du mois, tandis que ResolverStyle.LENIENT autorise le report des dépassements d’un champ à l’autre. Les règles dépendent des champs à résoudre. Par exemple, avec Java SE 21, lors de la résolution d’une date exprimée en semaines, les champs localisés de WeekFields peuvent ramener la semaine 53 à la semaine 52 dans une année de décompte des semaines qui n’en compte que 52, même en mode STRICT.

Définissez le style avec withResolverStyle(ResolverStyle.STRICT) et conservez le formateur renvoyé : la méthode ne modifie pas l’original. Un formateur créé avec ofPattern utilise SMART par défaut. Pour un motif de date sans ère, utilisez uuuu-MM-dd : uuuu désigne l’année, tandis que yyyy désigne l’année de l’ère, qui peut ne pas suffire à produire un LocalDate lors d’une résolution stricte sans ère.

L’exemple accepte 2024-02-29, mais intercepte DateTimeParseException pour 2023-02-29. Il affiche un message fixe plutôt que le texte d’exception, qui dépend de l’implémentation. Périmètre de la documentation : Java SE 21 ; les environnements d’exécution du dépôt et de production n’ont pas été attestés.

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) {
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        for (String text : new String[] {"2024-02-29", "2023-02-29"}) {
            try {
                System.out.println(LocalDate.parse(text, formatter));
            } catch (DateTimeParseException ex) {
                System.out.println("Rejected: " + text);
            }
        }
    }
}

Résultat

2024-02-29
Rejected: 2023-02-29

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources