CKTIS / Java
LocalDate — een datum zonder tijd of tijdzone
LocalDate stelt een onveranderlijke datum uit de ISO-kalender voor, zonder tijd of tijdzone. Je kunt er datums mee maken, verschuiven, vergelijken, parsen en formatteren.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
LocalDate.of(year, month, dayOfMonth)
date.plusDays(days)
date.isAfter(other)
date.toString()
date.equals(other)
date.compareTo(other)
date.with(adjuster)
date.with(field, newValue)
date.atTime(hour, minute)
LocalDate.parse(text)
LocalDate.parse(text, formatter)
date.format(formatter)java.time.LocalDate slaat een datum uit de ISO-kalender op zonder tijd of tijdzone; op zichzelf verwijst deze niet naar een moment op de tijdlijn. De klasse is onveranderlijk en thread-safe. LocalDate.of(year, month, dayOfMonth) maakt een datum; maanden zijn genummerd van 1 tot en met 12. Een ongeldige datum veroorzaakt DateTimeException.
LocalDate.plusDays geeft het resultaat van het optellen van dagen terug en houdt rekening met maandgrenzen en schrikkeljaren; het oorspronkelijke object blijft ongewijzigd. LocalDate.with(adjuster) past een aanpassingsregel toe, terwijl LocalDate.with(field, newValue) een veld instelt. De afhandeling van een ongeldige dag hangt af van het veld: bij een maandwijziging kan de dag worden begrensd tot het einde van de maand, maar een ongeldige DAY_OF_MONTH veroorzaakt een uitzondering.
LocalDate.isAfter controleert of een datum later is. LocalDate.equals vergelijkt datumwaarden van het type LocalDate, niet de objectidentiteit — vervang dit niet door ==. Voor twee LocalDate-objecten geeft LocalDate.compareTo volgens de volgorde van de datums een negatief getal, nul of een positief getal terug; ga er niet van uit dat de uitkomst precies -1 of 1 is.
LocalDate.parse(text) leest een ISO-datum; de overload met formatter ondersteunt een andere notatie. Een parsefout veroorzaakt DateTimeParseException. LocalDate.toString geeft ISO-tekst terug, terwijl LocalDate.format(formatter) de opgegeven formatter gebruikt. In het patroon dd/MM/uuuu betekent uuuu jaar, niet jaar van de era (yyyy).
LocalDate.atTime(hour, minute) maakt een LocalDateTime, nog steeds zonder tijdzone; de overload met OffsetTime geeft OffsetDateTime terug. Het voorbeeld gebruikt vaste datums en toont 29 februari 2024. Documentatiebereik: Java SE 21; de productieomgeving is niet bevestigd.
Voorbeelden
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;
public class Main {
public static void main(String[] args) {
LocalDate start = LocalDate.of(2024, 2, 28);
LocalDate next = start.plusDays(1);
LocalDate parsed = LocalDate.parse("2024-02-29");
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");
System.out.println(start.toString());
System.out.println(next.toString());
System.out.println(next.isAfter(start));
System.out.println(next.equals(parsed));
System.out.println(start.compareTo(next) < 0);
System.out.println(start.with(TemporalAdjusters.lastDayOfMonth()));
System.out.println(next.atTime(9, 30));
System.out.println(next.format(formatter));
}
}Resultaat
2024-02-28 2024-02-29 true true true 2024-02-29 2024-02-29T09:30 29/02/2024
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.