WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

LocalDate: Datumswerte erzeugen, verschieben, vergleichen und darstellen

Erzeuge ein ISO-Kalenderdatum, verschiebe es um Kalendertage, ohne das Original zu ändern, vergleiche es mit einem anderen Datum und gib es als Text aus.

Version: Java SE 21

Syntax

import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;

// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()

java.time.LocalDate steht für ein ISO-Kalenderdatum ohne Uhrzeit und Zeitzone. Die statische Fabrikmethode LocalDate.of erwartet in dieser Reihenfolge Jahr, Monat und Tag des Monats. Gib den Monat als int von 1 bis 12 oder als Month-Wert ungleich null an, etwa Month.FEBRUARY. Ein ungültiges Datum wie der 29. Februar in einem Nichtschaltjahr wird nicht korrigiert, sondern löst eine DateTimeException aus.

date.plusDays(n) nimmt die Anzahl der Kalendertage als long entgegen und liefert das resultierende Datum, bei Bedarf über Monats- oder Jahresgrenzen hinweg. Ein negativer Wert verschiebt das Datum in die Vergangenheit; null erhält den Datumswert. LocalDate ist unveränderlich: Der Aufruf ändert date nicht. Speichere oder verwende daher den Rückgabewert. Liegt das Ergebnis außerhalb des unterstützten Datumsbereichs und tritt bei der Berechnung kein Überlauf auf, löst die Methode eine DateTimeException aus, etwa bei LocalDate.MAX.plusDays(1). Führt in JDK 21 die Addition zur Anzahl der Tage seit der Epoche zu einem long-Überlauf, löst die Methode noch vor der Prüfung des Datumsbereichs eine ArithmeticException aus.

a.isAfter(b) liefert nur dann true, wenn a später als b liegt. Ist a früher oder bezeichnen beide denselben Tag, ist das Ergebnis false. Der Parameter hat den Typ ChronoLocalDate, und b darf nicht null sein. Verglichen wird die Position auf der lokalen Zeitachse, unabhängig vom jeweiligen Kalendersystem.

date.toString() liefert einen String im ISO-8601-Format uuuu-MM-dd, etwa 2024-03-01. Die Methode gibt selbst nichts aus und passt den Text nicht an ein Gebietsschema an. Verwende für eine leserfreundliche Darstellung format mit einem geeigneten DateTimeFormatter.

Beispiele

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate later = start.plusDays(2);

        System.out.println(start.toString());
        System.out.println(later.toString());
        System.out.println(later.isAfter(start));
        System.out.println(later.isAfter(later));
    }
}

Ergebnis

2024-02-28
2024-03-01
true
false

2024 ist ein Schaltjahr, daher ist `2024-03-01` zwei Tage nach `2024-02-28`. Die erste Zeile zeigt das unveränderte Ausgangsdatum; die letzten beiden zeigen, dass das Ergebnis später als das Ausgangsdatum liegt, aber nicht später als es selbst.

Zugehörige Lektionen

  • Java · Lektion 68 · Grundlagen · Version: 2

Quellen