WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

LocalDate.of — ein Datum aus Jahr, Monat und Tag erzeugen

Erzeuge ein ISO-Datum aus drei Angaben, wähle die passende Überladung und vergleiche Datumswerte mit `equals` statt Referenzen mit `==`.

Version: Java SE 21

Syntax

public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)

LocalDate.of ist eine statische Fabrikmethode der Klasse java.time.LocalDate. Sie erwartet Jahr, Monat und Tag des Monats in dieser Reihenfolge. Sie liefert ein unveränderliches Datum im ISO-8601-Kalender ohne Uhrzeit und Zeitzone. Anders als LocalDate.now() liest sie keine Uhr aus.

Das zweite Argument ist entweder ein int von 1 (Januar) bis 12 (Dezember) oder eine Konstante der Aufzählung java.time.Month, etwa Month.JANUARY. Das Jahr muss zwischen -999999999 und 999999999 einschließlich liegen. Der Tag muss zwischen 1 und 31 liegen und im angegebenen Monat und Jahr tatsächlich vorkommen. Ein Wert außerhalb des zulässigen Bereichs oder ein nicht existierendes Datum wie der 29. Februar 2019 löst eine DateTimeException aus; die Methode korrigiert das Datum nicht. null als Month löst eine NullPointerException aus.

LocalDate ist eine wertbasierte Klasse. Zwei Aufrufe für 2020-01-01 liefern gemäß equals gleiche Daten, garantieren aber keine getrennten Objekte. == vergleicht Referenzen, keine Datumswerte. Verwende LocalDate-Instanzen nicht zur Synchronisierung.

Beispiele

import java.time.DateTimeException;
import java.time.LocalDate;
import java.time.Month;

public class Main {
    public static void main(String[] args) {
        final int year = 2020;
        LocalDate january = LocalDate.of(year, 1, 1);
        LocalDate sameJanuary = LocalDate.of(year, Month.JANUARY, 1);
        LocalDate june = LocalDate.of(year, Month.JUNE, 1);
        LocalDate july = LocalDate.of(year, 7, 1);
        LocalDate previousDecember = LocalDate.of(year - 1, Month.DECEMBER, 31);

        System.out.println(january);
        System.out.println(june);
        System.out.println(july);
        System.out.println(previousDecember);
        System.out.println(january.equals(sameJanuary));

        try {
            LocalDate.of(year - 1, Month.FEBRUARY, 29);
        } catch (DateTimeException e) {
            System.out.println("DateTimeException");
        }
    }
}

Ergebnis

2020-01-01
2020-06-01
2020-07-01
2019-12-31
true
DateTimeException

Das Programm gibt feste Daten im Januar, Juni und Juli 2020 sowie ein Datum im Dezember des Vorjahres (`year - 1`) aus. Beide Überladungen liefern dasselbe Januardatum, daher gibt `equals` den Wert `true` zurück. Da 2019 kein Schaltjahr ist, gibt der `catch`-Block `DateTimeException` aus.

Zugehörige Lektionen

  • Java · Lektion 4 · Fortgeschritten · Version: 2
  • Java · Lektion 11 · Fortgeschritten · Version: 2

Quellen