CKTIS / Java
DateTimeFormatter — formatage et analyse des dates
DateTimeFormatter convertit les dates et heures en texte et analyse du texte. Découvrez les motifs, le choix explicite d’un Locale, la validation stricte et les différences entre MM et mm, ainsi qu’entre uuuu et yyyy.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm").withLocale(Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)DateTimeFormatter est immuable et sûr pour une utilisation concurrente. DateTimeFormatter.ofPattern crée un formateur à partir d’un motif ; vous pouvez le réutiliser pour formater et analyser des dates.
Pour MM et mm : MM désigne le mois sur deux chiffres, tandis que mm désigne les minutes sur deux chiffres. Pour uuuu et yyyy : uuuu désigne l’année proleptique, tandis que yyyy désigne l’année de l’ère. Pour analyser strictement une date ISO sans ère, utilisez uuuu ; yyyy seul ne suffit pas à déterminer la date.
DateTimeFormatter.withLocale renvoie un formateur associé au Locale choisi, qui influe notamment sur les noms des mois. DateTimeFormatter.withResolverStyle ne modifie pas non plus l’objet d’origine. Choisissez ResolverStyle.STRICT pour rejeter les dates invalides. Le mode par défaut de ofPattern, SMART, peut ramener le jour à la fin du mois, par exemple transformer 2023-02-29 en 2023-02-28.
L’exemple accepte 2024-02-29 09:07, mais rejette 2023-02-29 09:07. STRICT contrôle la résolution des champs lors de l’analyse, et non le formatage.
Exemples
import java.time.LocalDateTime;
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 HH:mm")
.withLocale(Locale.ROOT)
.withResolverStyle(ResolverStyle.STRICT);
LocalDateTime value = LocalDateTime.parse("2024-02-29 09:07", formatter);
System.out.println(value.format(formatter));
try {
LocalDateTime.parse("2023-02-29 09:07", formatter);
throw new AssertionError("Expected rejection");
} catch (DateTimeParseException ex) {
System.out.println("Invalid date rejected");
}
}
}Résultat
2024-02-29 09:07 Invalid date rejected
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.