CKTIS / Java
Datums en datum-tijdwaarden parsen, maken en opmaken in Java
Maak datums uit losse velden, lees ISO-tekst of een eigen notatie in en geef datums met of zonder tijd weer zonder een tijdzone toe te kennen.
Versie: 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 stelt LocalDate alleen een ISO-datum voor, terwijl LocalDateTime een ISO-datum combineert met een lokale tijd. Geen van beide slaat een tijdzone of UTC-offset op of bepaalt op zichzelf een uniek tijdstip. Beide typen zijn onveranderlijk.
LocalDate.of(year, month, dayOfMonth) is een statische fabrieksmethode die een maandnummer van 1 tot en met 12 of een Month-constante accepteert. De statische fabrieksmethode LocalDateTime.of(date, time) combineert een LocalDate met een LocalTime. De overloads met losse velden accepteren een maandnummer of Month, vereisen een uur en een minuut en laten je daarna een seconde en vervolgens een nanoseconde opgeven. Een weggelaten seconde of nanoseconde is nul. Ongeldige veldwaarden, zoals 29 februari in een niet-schrikkeljaar, leiden tot een DateTimeException.
De statische methode LocalDate.parse(text) gebruikt DateTimeFormatter.ISO_LOCAL_DATE, bijvoorbeeld voor 2024-02-29. De overload LocalDate.parse(text, formatter) gebruikt de meegegeven formatter, bijvoorbeeld met het patroon dd/MM/uuuu. Tekst die niet als datum kan worden ingelezen, leidt tot een DateTimeParseException. DateTimeFormatter.ofPattern gebruikt standaard SMART, dat 29/02/2023 kan aanpassen naar 28 februari. Stel ResolverStyle.STRICT in om zulke datums af te wijzen en gebruik uuuu (jaar), niet yyyy (jaar binnen een era).
De instantiemethoden LocalDate.format(formatter) en LocalDateTime.format(formatter) geven met de meegegeven formatter een String terug zonder de waarde te wijzigen. Als een vereist veld ontbreekt, bijvoorbeeld het uur voor HH:mm bij een LocalDate, leidt het formatteren tot een DateTimeException. LocalDate.toString() accepteert geen formatter en geeft ISO-8601-tekst terug, zoals 2024-02-29. Patronen zijn hoofdlettergevoelig: MM betekent maand, mm minuut en HH uur in 24-uursnotatie.
Voorbeelden
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");
}
}
}Resultaat
true 2024-02-29 29/02/2024 29/02/2024 09:05 Invalid date rejected
De eerste regel bevestigt dat beide ingelezen waarden gelijk zijn aan de datum uit de fabrieksmethode. De volgende drie regels tonen de ISO-datum, de datum in de eigen notatie en de datum met tijd. De laatste regel laat zien dat strikt parsen 29 februari 2023 afwijst.
Gerelateerde lessen
- Java · Les 61 · Gevorderd · Versie: 2