KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

LocalDate: datums maken, verschuiven, vergelijken en weergeven

Maak een ISO-kalenderdatum, verschuif die met kalenderdagen zonder het origineel te wijzigen, vergelijk die met een andere datum en zet de datum om naar tekst.

Versie: Java SE 21

Syntax

import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;

// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()

java.time.LocalDate stelt een ISO-kalenderdatum voor zonder tijdstip op de dag of tijdzone. De statische fabrieksmethode LocalDate.of krijgt achtereenvolgens het jaar, de maand en de dag van de maand. Geef de maand op als int van 1 tot en met 12 of als een Month-waarde die niet null is, zoals Month.FEBRUARY. Een ongeldige datum, zoals 29 februari in een niet-schrikkeljaar, wordt niet gecorrigeerd maar leidt tot een DateTimeException.

date.plusDays(n) neemt een aantal kalenderdagen van het type long en geeft de resulterende datum terug. Zo nodig gaat de berekening over een maand- of jaargrens heen. Een negatief getal gaat terug in de tijd; nul behoudt de datumwaarde. LocalDate is onveranderlijk: de aanroep wijzigt date niet, dus bewaar of gebruik de retourwaarde. Als de berekening geen overflow veroorzaakt maar de resulterende datum buiten het ondersteunde bereik valt, gooit de methode een DateTimeException, bijvoorbeeld bij LocalDate.MAX.plusDays(1). Als in JDK 21 de tussentijdse optelling bij het aantal dagen sinds de epoch buiten het bereik van long valt, gooit de methode een ArithmeticException voordat ze het datumbereik controleert.

a.isAfter(b) geeft alleen true terug als a later valt dan b. Als a eerder valt of beide dezelfde dag voorstellen, krijg je false. De parameter heeft het type ChronoLocalDate en b mag niet null zijn. De vergelijking kijkt naar de positie van de datums op de lokale tijdlijn, ongeacht hun kalendersysteem.

date.toString() geeft een String in ISO-8601-notatie uuuu-MM-dd terug, zoals 2024-03-01. De methode drukt niets af en past de tekst niet aan de landinstellingen aan. Gebruik voor weergave aan de lezer format met een geschikte DateTimeFormatter.

Voorbeelden

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate later = start.plusDays(2);

        System.out.println(start.toString());
        System.out.println(later.toString());
        System.out.println(later.isAfter(start));
        System.out.println(later.isAfter(later));
    }
}

Resultaat

2024-02-28
2024-03-01
true
false

2024 is een schrikkeljaar, dus twee dagen na `2024-02-28` is het `2024-03-01`. De eerste regel toont dat de begindatum onveranderd is; de laatste twee tonen dat het resultaat later valt dan de begindatum, maar niet later dan zichzelf.

Gerelateerde lessen

  • Java · Les 68 · Basis · Versie: 2

Bronnen