WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Die 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

Quellen