KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Period — een kalenderperiode tussen datums

java.time.Period geeft een periode in jaren, maanden en dagen weer. Period.between berekent die periode tussen twee LocalDate-waarden, en niet de verstreken tijd in seconden.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)

java.time.Period is een onveranderlijke, threadveilige waarde die jaren, maanden en dagen in de ISO-kalender weergeeft. Gebruik deze voor kalenderberekeningen; Duration geeft tijd in seconden en nanoseconden weer. Een kalenderdag hoeft bij een overgang naar zomer- of wintertijd niet gelijk te zijn aan 24 uur.

Period.between(start, end) accepteert twee niet-null LocalDate-waarden: de startdatum telt mee en de einddatum niet. De methode berekent volledige maanden en resterende dagen en verdeelt de maanden daarna in jaren en maanden. Een eerdere einddatum levert een negatieve periode op.

getDays() geeft alleen de component voor dagen terug, niet het totale aantal dagen. In het voorbeeld betekent P1Y2M3D één jaar, twee maanden en drie dagen. start.plus(period) maakt een nieuwe datum aan; start wordt niet gewijzigd.

Voorbeelden

import java.time.LocalDate;
import java.time.Period;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2023, 1, 15);
        LocalDate end = LocalDate.of(2024, 3, 18);
        Period period = Period.between(start, end);

        System.out.println(period);
        System.out.println(period.getDays());
        System.out.println(start.plus(period));
    }
}

Resultaat

P1Y2M3D
3
2024-03-18

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