CKTIS / Java
Datum und Datum mit Uhrzeit in Java einlesen, erzeugen und formatieren
Erzeuge Datumswerte aus einzelnen Feldern, lies ISO-Text oder eigene Formate ein und gib Datum und Uhrzeit aus, ohne eine Zeitzone zuzuweisen.
Version: Java SE 21
Syntax
Java SE 21 — java.time.LocalDate and java.time.LocalDateTime; formatter type: java.time.format.DateTimeFormatter
Static factory and parsing methods:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDate LocalDate.parse(CharSequence text)
LocalDate LocalDate.parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.of also accepts java.time.Month instead of an int month. Both component-based forms have overloads with a trailing int second or with trailing int second, int nanoOfSecond.
Instance methods:
String date.format(DateTimeFormatter formatter) // date: LocalDate
String date.toString() // date: LocalDate
String dateTime.format(DateTimeFormatter formatter) // dateTime: LocalDateTimeIn java.time steht LocalDate für ein reines ISO-Datum, während LocalDateTime ein ISO-Datum mit einer lokalen Uhrzeit verbindet. Keiner der beiden Typen speichert eine Zeitzone oder einen UTC-Offset oder legt für sich allein einen eindeutigen Zeitpunkt fest. Beide Typen sind unveränderlich.
LocalDate.of(year, month, dayOfMonth) ist eine statische Fabrikmethode, die eine Monatszahl von 1 bis 12 oder eine Month-Konstante annimmt. Die statische Fabrikmethode LocalDateTime.of(date, time) verbindet LocalDate und LocalTime. Die Überladungen für einzelne Felder akzeptieren eine Monatszahl oder Month, verlangen Stunde und Minute und erlauben zusätzlich eine Sekunde und danach eine Nanosekunde. Nicht angegebene Sekunden oder Nanosekunden sind null. Ungültige Feldwerte wie der 29. Februar in einem Nichtschaltjahr führen zu DateTimeException.
Die statische Methode LocalDate.parse(text) verwendet DateTimeFormatter.ISO_LOCAL_DATE, etwa für 2024-02-29. Die Überladung LocalDate.parse(text, formatter) verwendet den übergebenen Formatierer, etwa mit dem Muster dd/MM/uuuu. Lässt sich der Text nicht als Datum einlesen, wird DateTimeParseException ausgelöst. DateTimeFormatter.ofPattern verwendet standardmäßig SMART, wodurch 29/02/2023 auf den 28. Februar korrigiert werden kann. Um solche Daten abzulehnen, verwende ResolverStyle.STRICT und uuuu (Jahr) statt yyyy (Jahr innerhalb einer Ära).
Die Instanzmethoden LocalDate.format(formatter) und LocalDateTime.format(formatter) geben mit dem übergebenen Formatierer einen String zurück, ohne den Wert zu verändern. Fehlt ein erforderliches Feld, etwa die Stunde für HH:mm bei einem LocalDate, löst die Formatierung DateTimeException aus. LocalDate.toString() nimmt keinen Formatierer an und liefert ISO-8601-Text wie 2024-02-29. Bei Mustern zählt die Groß- und Kleinschreibung: MM steht für den Monat, mm für die Minute und HH für die Stunde im 24-Stunden-Format.
Beispiele
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;
public class Main {
public static void main(String[] args) {
DateTimeFormatter dateFormat = DateTimeFormatter
.ofPattern("dd/MM/uuuu", Locale.ROOT)
.withResolverStyle(ResolverStyle.STRICT);
DateTimeFormatter dateTimeFormat = DateTimeFormatter
.ofPattern("dd/MM/uuuu HH:mm", Locale.ROOT);
LocalDate date = LocalDate.of(2024, 2, 29);
LocalDate fromIso = LocalDate.parse("2024-02-29");
LocalDate fromCustom = LocalDate.parse("29/02/2024", dateFormat);
System.out.println(date.equals(fromIso) && date.equals(fromCustom));
System.out.println(date.toString());
System.out.println(date.format(dateFormat));
LocalDateTime dateTime = LocalDateTime.of(date, LocalTime.of(9, 5));
System.out.println(dateTime.format(dateTimeFormat));
try {
LocalDate.parse("29/02/2023", dateFormat);
System.out.println("Unexpected success");
} catch (DateTimeParseException e) {
System.out.println("Invalid date rejected");
}
}
}Ergebnis
true 2024-02-29 29/02/2024 29/02/2024 09:05 Invalid date rejected
Die erste Zeile bestätigt, dass beide eingelesenen Werte dem Datum aus der Fabrikmethode entsprechen. Die nächsten drei Zeilen zeigen das ISO-Datum, das frei formatierte Datum und das Datum mit Uhrzeit. Die letzte Zeile zeigt, dass das strikte Einlesen den 29. Februar 2023 ablehnt.
Zugehörige Lektionen
- Java · Lektion 61 · Fortgeschritten · Version: 2