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

CKTIS / Java

Period.between : années, mois, jours et total de jours

Calculez une période calendaire entre deux dates et lisez ses composantes. Pour obtenir le nombre total de jours, partez directement des deux dates.

Version : Java SE 21

Syntaxe

import java.time.LocalDate;
import java.time.Period;
import java.time.temporal.ChronoUnit;

// start and end are LocalDate values.
Period period = Period.between(start, end);
int years = period.getYears();
int months = period.getMonths();
int days = period.getDays();
long totalDays = ChronoUnit.DAYS.between(start, end);

La méthode statique Period.between(start, end) de java.time.Period prend deux valeurs LocalDate, qui ne contiennent ni heure ni fuseau horaire. La date de début est incluse et la date de fin est exclue. La méthode détermine les mois complets et les jours restants, puis décompose les mois complets en années de 12 mois et en mois restants.

Les méthodes getYears(), getMonths() et getDays() renvoient respectivement les composantes en années, en mois et en jours, chacune de type int. Dans le résultat de between, la composante en mois ne compte pas les mois déjà compris dans les années, et la composante en jours ne contient que les jours qui restent après décompte des mois complets. Si les dates sont identiques, les trois composantes valent zéro. Si la date de fin précède celle de début, chaque composante non nulle est négative.

Pour obtenir le nombre total de jours calendaires, utilisez ChronoUnit.DAYS.between(start, end) du paquet java.time.temporal. Le résultat est de type long, exclut la date de fin et est négatif si la fin précède le début. Ne convertissez pas les composantes de Period en supposant un nombre fixe de jours par mois ou par an : leur longueur varie selon le calendrier.

Exemples

import java.time.LocalDate;
import java.time.Period;
import java.time.temporal.ChronoUnit;

public class PeriodExample {
    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);
        long totalDays = ChronoUnit.DAYS.between(start, end);

        System.out.println("years=" + period.getYears());
        System.out.println("months=" + period.getMonths());
        System.out.println("days=" + period.getDays());
        System.out.println("totalDays=" + totalDays);
    }
}

Résultat

years=1
months=2
days=3
totalDays=428

Du `2023-01-15` au `2024-03-18`, la période est de 1 an, 2 mois et 3 jours. Ainsi, `getDays()` renvoie `3`, tandis que `ChronoUnit.DAYS.between(start, end)` renvoie `428`.

Leçons associées

  • Java · Leçon 68 · Débutant · Version : 2

Sources