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

CKTIS / Java

ChronoUnit.DAYS.between — nombre de jours entre deux dates

ChronoUnit.DAYS.between(start, end) renvoie le nombre de jours complets sous forme de long. Avec LocalDate, la méthode calcule la différence entre les dates du calendrier ; si la fin précède le début, le résultat est négatif.

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

Syntaxe

long days = ChronoUnit.DAYS.between(startInclusive, endExclusive);

ChronoUnit.DAYS.between(start, end) renvoie un long : le nombre de jours complets entre des objets temporels compatibles. Le début est inclus et la fin est exclue. L’écriture équivalente est start.until(end, ChronoUnit.DAYS).

Avec LocalDate, la méthode calcule la différence entre les dates du calendrier. L’exemple inclut le 29 février 2024 : du 2024-02-28 au 2024-03-01, il y a 2 jours, et non 3. Inverser ces arguments donne -2, et des dates identiques donnent 0.

La signification d’un jour complet dépend des types d’arguments. DAYS est une unité basée sur la date ; ne supposez pas qu’un jour correspond toujours exactement à 24 heures, notamment lors des changements d’heure saisonniers. Les arguments doivent être non nuls, compatibles et prendre en charge cette unité ; une unité non prise en charge entraîne UnsupportedTemporalTypeException. Le calcul ne modifie pas les arguments.

Exemples

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

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

        System.out.println(ChronoUnit.DAYS.between(start, end));
        System.out.println(ChronoUnit.DAYS.between(end, start));
        System.out.println(ChronoUnit.DAYS.between(start, start));
    }
}

Résultat

2
-2
0

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