KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen