WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

LocalDateTime erzeugen und den Montag einer ISO-Woche bestimmen

Erzeuge lokale Datums- und Uhrzeitwerte aus festen Eingaben, bestimme den Montag derselben ISO-Woche und wähle die Überladung mit dem passenden Rückgabetyp.

Version: Java SE 21

Syntax

Java SE 21 — java.time

Static factories:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute, int second)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
The same three component overloads accept Month instead of int for month.
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)

Instance methods on a LocalDate named date:
LocalDate date.with(TemporalAdjuster adjuster)
LocalDate date.with(TemporalField field, long newValue)
LocalDateTime date.atTime(int hour, int minute)
LocalDateTime date.atTime(int hour, int minute, int second)
LocalDateTime date.atTime(int hour, int minute, int second, int nanoOfSecond)
LocalDateTime date.atTime(LocalTime time)
OffsetDateTime date.atTime(OffsetTime time)

Common composition: date.with(DayOfWeek.MONDAY).atTime(9, 30)

Im Paket java.time erzeugt die statische Fabrikmethode LocalDate.of ein ISO-Datum aus Jahr, Monat und Tag des Monats. Den Monat gibst du als Zahl von 1 bis 12 oder als Month-Wert wie Month.MARCH an. Die statische Fabrikmethode LocalDateTime.of nimmt dieselben Datumskomponenten sowie Stunde und Minute entgegen; weitere Überladungen akzeptieren zusätzlich Sekunden und danach Nanosekunden. Nicht angegebene Sekunden und Nanosekunden sind null. Eine weitere Überladung kombiniert ein vorhandenes LocalDate mit einem LocalTime.

Die Instanzmethode LocalDate.with lässt das ursprüngliche Datum unverändert: Verwende den Rückgabewert. In date.with(DayOfWeek.MONDAY) fungiert der Enum-Wert als TemporalAdjuster und wählt unabhängig von den Ländereinstellungen den Montag derselben ISO-Woche (Montag bis Sonntag). Ist das Datum bereits ein Montag, bleibt sein Wert gleich; sonst liegt das Ergebnis früher und kann in einen anderen Monat oder ein anderes Jahr fallen. Die Überladung with(TemporalField, long) setzt ein Feld auf einen Zahlenwert. Bei ChronoField.DAY_OF_WEEK wählt 1 ebenfalls den Montag derselben ISO-Woche.

Die Instanzmethode LocalDate.atTime kombiniert das Datum mit einem LocalTime oder mit Zeitkomponenten: Stunde und Minute, optional gefolgt von Sekunden und danach Nanosekunden. Nicht angegebene Komponenten sind null. Mit einem LocalTime liefert date.atTime(time) denselben Wert wie LocalDateTime.of(date, time). Die Überladung mit OffsetTime gibt dagegen ein OffsetDateTime zurück und behält den UTC-Offset bei.

Die Fabrikmethoden of werfen bei einem ungültigen Datum eine DateTimeException. Überladungen mit numerischen Zeitkomponenten werfen diese Ausnahme bei Werten außerhalb des zulässigen Bereichs, etwa bei Stunde 24. LocalDate und LocalDateTime sind unveränderlich. Ein LocalDateTime enthält weder eine Zeitzone noch einen UTC-Offset und bestimmt deshalb für sich genommen keinen eindeutigen Zeitpunkt.

Beispiele

import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.Month;

public class Main {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2024, Month.MARCH, 1);
        LocalDate monday = date.with(DayOfWeek.MONDAY);

        LocalDateTime adjusted = monday.atTime(9, 30);
        LocalDateTime direct = LocalDateTime.of(2024, 2, 26, 9, 30);
        LocalDateTime combined = LocalDateTime.of(monday, LocalTime.of(9, 30));

        System.out.println(date);
        System.out.println(adjusted);
        System.out.println(adjusted.equals(direct) && adjusted.equals(combined));
    }
}

Ergebnis

2024-03-01
2024-02-26T09:30
true

Die Eingabe ist Freitag, `2024-03-01`. Der zugehörige Montag, `2024-02-26`, liegt im Vormonat. Mit der Uhrzeit `09:30` ergeben alle drei Wege gleiche `LocalDateTime`-Werte, wie `true` zeigt.

Zugehörige Lektionen

  • Java · Lektion 60 · Fortgeschritten · Version: 2

Quellen