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

CKTIS / Java

LocalDate.compareTo : classer des commandes uniquement par date

Utilisez le signe du résultat de `LocalDate.compareTo` pour ordonner des dates. Avec un classement par date seule, les commandes du même jour se comparent comme égales, même si leurs titres diffèrent.

Version : Java SE 21

Syntaxe

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

// Instance method declared by LocalDate:
public int compareTo(ChronoLocalDate other)

// Call with a LocalDate receiver and a non-null ChronoLocalDate argument:
int result = date.compareTo(other);

La méthode d’instance LocalDate.compareTo prend un argument de type java.time.chrono.ChronoLocalDate : vous pouvez donc lui passer un autre LocalDate. Un java.time.LocalDate représente une date ISO sans heure ni fuseau horaire.

Pour deux valeurs LocalDate, un résultat < 0 signifie que la date de l’objet appelant est antérieure, == 0 indique la même date et > 0 indique une date postérieure. Testez le signe : un résultat non nul ne vaut pas forcément -1 ou 1 et ne correspond pas à un nombre de jours. Passer null déclenche une NullPointerException.

Pour des dates issues de calendriers différents, compareTo compare d’abord les jours sur l’axe temporel local. Si les deux dates représentent le même jour, l’identifiant de chronologie les départage. Utilisez isEqual pour vérifier qu’il s’agit du même jour sans tenir compte de la chronologie.

Dans l’exemple, Order.compareTo compare uniquement date ; title ne départage pas les ex æquo. Deux commandes de même date mais de titres différents donnent 0, alors que la méthode equals générée pour le record renvoie false. Un TreeSet utilisant cet ordre naturel ne stocke donc pas les deux comme éléments distincts.

Exemples

import java.time.LocalDate;

public class Main {
    record Order(LocalDate date, String title) implements Comparable<Order> {
        @Override
        public int compareTo(Order other) {
            return date.compareTo(other.date());
        }
    }

    public static void main(String[] args) {
        var first = new Order(LocalDate.of(2025, 4, 2), "Zebra");
        var later = new Order(LocalDate.of(2025, 4, 5), "Alpha");
        var sameDay = new Order(LocalDate.of(2025, 4, 2), "Beta");

        System.out.println(Integer.signum(first.compareTo(later)));
        System.out.println(Integer.signum(later.compareTo(first)));
        System.out.println(Integer.signum(first.compareTo(sameDay)));
        System.out.println(first.equals(sameDay));
    }
}

Résultat

-1
1
0
false

`Integer.signum` ramène les résultats des comparaisons à `-1`, `1` et `0` : avant, après et le même jour. Le dernier `false` porte sur l’égalité des records, pas sur l’ordre des dates.

Leçons associées

  • Java · Leçon 11 · Avancé · Version : 2

Sources