CKTIS / Java
Lokales Datum und Uhrzeit erzeugen und verschieben
Erzeuge mit `LocalDateTime.of` ein lokales Datum mit Uhrzeit und addiere Stunden oder Minuten, ohne den Ausgangswert zu ändern.
Version: Java SE 21
Syntax
import java.time.LocalDateTime;
LocalDateTime start = LocalDateTime.of(year, month, dayOfMonth, hour, minute);
LocalDateTime later = start.plusHours(hours).plusMinutes(minutes);
// Factory arguments shown: int. Amounts passed to plusHours and plusMinutes: long.java.time.LocalDateTime verbindet ein Kalenderdatum mit einer Uhrzeit, wie sie auf einer Uhr steht. Der Typ speichert weder eine Zeitzone noch einen UTC-Offset und bestimmt für sich genommen keinen eindeutigen Zeitpunkt. Die Berechnung berücksichtigt keine Sommerzeitumstellungen.
Die statische Fabrikmethode LocalDateTime.of(year, month, dayOfMonth, hour, minute) erwartet in der gezeigten Form fünf int-Argumente; die Monate sind von 1 bis 12 nummeriert. Sie setzt das Sekunden- und das Nanosekundenfeld auf null. Andere Überladungen erlauben es, Sekunden und optional Nanosekunden anzugeben, eine Month-Konstante statt der Monatsnummer zu verwenden oder LocalDate und LocalTime zu kombinieren. Bei Überladungen mit einzelnen Feldern führt ein ungültiges Datum oder ein Feldwert außerhalb des zulässigen Bereichs zu einer DateTimeException.
Die Instanzmethoden plusHours(long hours) und plusMinutes(long minutes) addieren Stunden bzw. Minuten. Ein negativer Wert verschiebt Datum und Uhrzeit zurück. Beim Überschreiten von Mitternacht ändert sich auch das Datum. Liegt das Ergebnis außerhalb des unterstützten Datumsbereichs, wird eine DateTimeException ausgelöst.
LocalDateTime ist unveränderlich: Die Methoden geben das Ergebnis zurück, ohne das Objekt zu ändern, auf dem sie aufgerufen wurden. Speichere den Rückgabewert oder verwende ihn direkt im nächsten Aufruf, etwa in start.plusHours(1).plusMinutes(20).
Beispiele
import java.time.LocalDateTime;
public class LocalDateTimeDemo {
public static void main(String[] args) {
LocalDateTime start = LocalDateTime.of(2026, 4, 30, 22, 50);
LocalDateTime afterHours = start.plusHours(1);
LocalDateTime afterMinutes = afterHours.plusMinutes(20);
System.out.println(start);
System.out.println(afterHours);
System.out.println(afterMinutes);
System.out.println(start);
}
}Ergebnis
2026-04-30T22:50 2026-04-30T23:50 2026-05-01T00:10 2026-04-30T22:50
Eine Stunde später ist es 23:50, weitere 20 Minuten ergeben den 1. Mai um 00:10. Die letzte Zeile wiederholt das ursprüngliche Datum mit Uhrzeit. Die Ausgabe trennt Datum und Uhrzeit mit `T` und lässt das Sekunden- und Nanosekundenfeld weg, da beide null sind.
Zugehörige Lektionen
- Java · Lektion 68 · Grundlagen · Version: 2