CKTIS / Java
DateTimeFormatter: Muster, Locale und striktes Parsen
Muster und Locale bestimmen die Textdarstellung, der Auflösungsstil bestimmt die Datumsprüfung. Unterscheide `MM` von `mm` und `uuuu` von `yyyy`.
Version: Java SE 21
Syntax
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.ResolverStyleDie statische Methode DateTimeFormatter.ofPattern erzeugt einen Formatierer aus einem Muster. ofPattern(String) verwendet die Standard-Locale der Kategorie FORMAT, ofPattern(String, Locale) die explizit angegebene Locale. Beide beginnen mit SMART. Ein ungültiges Muster löst schon beim Erzeugen IllegalArgumentException aus.
Groß- und Kleinschreibung sind relevant: dd steht für den Tag des Monats, MM für den numerischen Monat und mm für Minuten. dd-MM-uuuu, dd/MM/uuuu und uuuu-MM-dd legen Feldreihenfolge und Trennzeichen fest. uuuu bezeichnet das proleptische Jahr (mit Jahr null), yyyy das Jahr der Ära. Beim strikten ISO-Parsen reichen yyyy, Monat und Tag für ein LocalDate nicht aus, weil keine Ära angenommen wird. Verwende uuuu für Datumsangaben ohne Ära.
DateTimeFormatter.withLocale setzt die Locale des zurückgegebenen Formatierers. Sie beeinflusst beim Formatieren und Parsen z. B. ausgeschriebene Monatsnamen (MMMM), ändert aber weder die Feldreihenfolge noch die Trennzeichen eines expliziten Musters. Formatierer sind unveränderlich und threadsicher: Verwende den Rückgabewert von withLocale oder withResolverStyle, denn das Original bleibt unverändert.
DateTimeFormatter.withResolverStyle steuert die zweite Phase des Parsens: Nachdem das Muster zum Einlesen der Felder verwendet wurde, werden diese zu einem Datum aufgelöst. Die Formatierung bleibt unverändert. Bei ISO-Datumsangaben weist STRICT unmögliche Daten zurück, SMART kann einen Tag von 1–31 auf den letzten Tag des Monats begrenzen, und LENIENT kann überschüssige Tage in den nächsten Monat übertragen. LocalDate.parse(text, formatter) löst DateTimeParseException aus, wenn der Text nicht passt oder kein Datum daraus gebildet werden kann.
Beispiele
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");
}
}
}
Ergebnis
05 January 2024 05 janvier 2024 SMART: 2024-02-29 STRICT: rejected
Die Locale ändert den Monatsnamen, nicht den Aufbau des Datums. Die Namen hängen von den Lokalisierungsdaten der Laufzeitumgebung ab. Für `31-02-2024` liefert `SMART` den Wert `2024-02-29`, während `STRICT` die Eingabe ablehnt.
Zugehörige Lektionen
- Java · Lektion 61 · Fortgeschritten · Version: 2