WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

DateTimeFormatter — Datumsformatierung und -analyse

DateTimeFormatter wandelt Datums- und Zeitangaben in Text um und analysiert Text. Lerne Formatmuster, die explizite Auswahl eines Locale, strenge Validierung sowie die Unterschiede zwischen MM und mm und zwischen uuuu und yyyy kennen.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm").withLocale(Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

DateTimeFormatter ist unveränderlich und threadsicher. DateTimeFormatter.ofPattern erstellt anhand eines Musters einen Formatter, der wiederholt zum Formatieren und Analysieren verwendet werden kann.

Zum Unterschied MM und mm: MM steht für den zweistelligen Monat, mm für zweistellige Minuten. Zum Unterschied uuuu und yyyy: uuuu bezeichnet das proleptische Jahr, yyyy das Jahr innerhalb einer Ära. Verwende für die strenge Analyse von ISO-Datumsangaben ohne Ära uuuu; yyyy allein reicht nicht aus, um das Datum zu bestimmen.

DateTimeFormatter.withLocale gibt einen Formatter mit dem ausgewählten Locale zurück, das zum Beispiel Monatsnamen beeinflusst. Auch DateTimeFormatter.withResolverStyle verändert das ursprüngliche Objekt nicht. Wähle ResolverStyle.STRICT, um ungültige Datumsangaben abzulehnen. Der Standardmodus von ofPattern, SMART, kann den Tag auf das Monatsende korrigieren, zum Beispiel 2023-02-29 zu 2023-02-28.

Das Beispiel akzeptiert 2024-02-29 09:07, lehnt aber 2023-02-29 09:07 ab. STRICT steuert die Auflösung von Feldern während der Analyse, nicht die Formatierung.

Beispiele

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");
        }
    }
}

Ergebnis

2024-02-29 09:07
Invalid date rejected

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen