Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Period — une période calendaire entre deux dates

java.time.Period représente une durée exprimée en années, mois et jours. Period.between calcule cette durée entre deux valeurs LocalDate, et non le temps écoulé en secondes.

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

Syntaxe

Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)

java.time.Period est une valeur immuable et sûre pour une utilisation concurrente, qui représente des années, des mois et des jours dans le calendrier ISO. Utilisez-la pour les calculs calendaires ; Duration représente le temps en secondes et en nanosecondes. Un jour calendaire ne correspond pas nécessairement à 24 heures lors d’un changement d’heure.

Period.between(start, end) accepte deux valeurs LocalDate non nulles : le début est inclus et la fin est exclue. La méthode calcule les mois complets et les jours restants, puis répartit les mois entre années et mois. Une date de fin antérieure produit une période négative.

getDays() renvoie uniquement la composante en jours, et non le nombre total de jours. Dans l’exemple, P1Y2M3D signifie un an, deux mois et trois jours. start.plus(period) crée une nouvelle date ; la valeur start n’est pas modifiée.

Exemples

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));
    }
}

Résultat

P1Y2M3D
3
2024-03-18

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources