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.ResolverStyleLa 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