WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

LocalDate — ein Datum ohne Uhrzeit und Zeitzone

LocalDate stellt ein unveränderliches Datum des ISO-Kalenders ohne Uhrzeit und Zeitzone dar. Damit lassen sich Datumswerte erstellen, verschieben, vergleichen, einlesen und formatieren.

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

Syntax

LocalDate.of(year, month, dayOfMonth)
date.plusDays(days)
date.isAfter(other)
date.toString()
date.equals(other)
date.compareTo(other)
date.with(adjuster)
date.with(field, newValue)
date.atTime(hour, minute)
LocalDate.parse(text)
LocalDate.parse(text, formatter)
date.format(formatter)

java.time.LocalDate speichert ein Datum des ISO-Kalenders ohne Uhrzeit und Zeitzone; allein bezeichnet es keinen Zeitpunkt auf der Zeitachse. Es ist unveränderlich und threadsicher. LocalDate.of(year, month, dayOfMonth) erstellt ein Datum; Monate werden von 1 bis 12 nummeriert. Ein ungültiges Datum führt zu DateTimeException.

LocalDate.plusDays gibt das Ergebnis der Addition von Tagen zurück und berücksichtigt Monatsgrenzen und Schaltjahre; das ursprüngliche Objekt bleibt unverändert. LocalDate.with(adjuster) wendet eine Anpassungsregel an, während LocalDate.with(field, newValue) ein Feld setzt. Wie ein ungültiger Tag behandelt wird, hängt vom Feld ab: Beim Ändern des Monats kann der Tag auf das Monatsende begrenzt werden, ein ungültiger DAY_OF_MONTH führt jedoch zu einer Ausnahme.

LocalDate.isAfter prüft, ob ein Datum später liegt. LocalDate.equals vergleicht Datumswerte vom Typ LocalDate, nicht die Objektidentität — ersetze es nicht durch ==. Für zwei LocalDate-Objekte liefert LocalDate.compareTo entsprechend der Datumsreihenfolge eine negative Zahl, null oder eine positive Zahl zurück; gehe nicht davon aus, dass das Ergebnis genau -1 oder 1 ist.

LocalDate.parse(text) liest ein ISO-Datum ein; die Formatter-Überladung unterstützt ein anderes Format. Ein Parsing-Fehler führt zu DateTimeParseException. LocalDate.toString gibt ISO-Text zurück, während LocalDate.format(formatter) den angegebenen Formatter verwendet. Im Muster dd/MM/uuuu bedeutet uuuu Jahr, nicht Jahr der Ära (yyyy).

LocalDate.atTime(hour, minute) erstellt ein LocalDateTime, weiterhin ohne Zeitzone; die Überladung mit OffsetTime gibt OffsetDateTime zurück. Das Beispiel verwendet feste Datumswerte und zeigt den 29. Februar 2024. Dokumentationsumfang: Java SE 21; die Produktionslaufzeit ist nicht bestätigt.

Beispiele

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate next = start.plusDays(1);
        LocalDate parsed = LocalDate.parse("2024-02-29");
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");

        System.out.println(start.toString());
        System.out.println(next.toString());
        System.out.println(next.isAfter(start));
        System.out.println(next.equals(parsed));
        System.out.println(start.compareTo(next) < 0);
        System.out.println(start.with(TemporalAdjusters.lastDayOfMonth()));
        System.out.println(next.atTime(9, 30));
        System.out.println(next.format(formatter));
    }
}

Ergebnis

2024-02-28
2024-02-29
true
true
true
2024-02-29
2024-02-29T09:30
29/02/2024

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