Comparer des dates en Java : Un guide complet

Java offre plusieurs manières de comparer des dates, chacune ayant ses propres forces et faiblesses. Ce guide explore les méthodes les plus courantes, en se concentrant à la fois sur la classe héritée java.util.Date et sur l’API moderne java.time, fortement recommandée pour les nouveaux projets.

Table des matières

• Utiliser before() et after()
• Utiliser equals()
• Utiliser compareTo()
• Comparaison moderne de dates/heures avec java.time

Utiliser before() et after()

Les méthodes before() et after(), faisant partie de la classe java.util.Date, offrent des comparaisons simples. before(Date otherDate) renvoie true si la date actuelle est avant otherDate, et after(Date otherDate) renvoie true si elle est après. Cependant, n’oubliez pas que java.util.Date inclut des informations temporelles, affectant la comparaison.

import java.util.Date;
import java.text.ParseException;
import java.text.SimpleDateFormat;

public class DateComparison {
    public static void main(String[] args) throws ParseException {
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
        Date date1 = formatter.parse("2023-10-26");
        Date date2 = formatter.parse("2024-01-15");

        System.out.println("date1 avant date2 : " + date1.before(date2)); // true
        System.out.println("date2 après date1 : " + date2.after(date1)); // true
    }
}

Utiliser equals()

La méthode equals() vérifie l’égalité exacte entre deux objets java.util.Date. Les composants date et heure doivent correspondre pour qu’elle renvoie true. Même une différence d’une milliseconde entraînera false.

import java.util.Date;
import java.text.ParseException;
import java.text.SimpleDateFormat;

public class DateComparison {
    public static void main(String[] args) throws ParseException {
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        Date date1 = formatter.parse("2023-10-26 10:00:00");
        Date date2 = formatter.parse("2023-10-26 10:00:00");

        System.out.println("date1 égale date2 : " + date1.equals(date2)); // true
    }
}

Utiliser compareTo()

La méthode compareTo(Date otherDate) fournit une comparaison plus nuancée. Elle renvoie :

• Une valeur négative si la date actuelle est avant otherDate.
• Zéro si les dates sont égales.
• Une valeur positive si la date actuelle est après otherDate.

import java.util.Date;
import java.text.ParseException;
import java.text.SimpleDateFormat;

public class DateComparison {
    public static void main(String[] args) throws ParseException {
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
        Date date1 = formatter.parse("2023-10-26");
        Date date2 = formatter.parse("2024-01-15");

        System.out.println("date1 compareTo date2 : " + date1.compareTo(date2)); // Négatif
        System.out.println("date2 compareTo date1 : " + date2.compareTo(date1)); // Positif
    }
}

Comparaison moderne de dates/heures avec java.time

L’API java.time (Java 8 et versions ultérieures) fournit une approche supérieure à la gestion des dates et des heures. Des classes comme LocalDate, LocalDateTime et ZonedDateTime offrent des comparaisons plus précises et plus claires. Elles évitent également les pièges de java.util.Date.

import java.time.LocalDate;
import java.time.LocalDateTime;

public class ModernDateComparison {
    public static void main(String[] args) {
        LocalDate date1 = LocalDate.of(2023, 10, 26);
        LocalDate date2 = LocalDate.of(2024, 1, 15);

        System.out.println("date1 est avant date2 : " + date1.isBefore(date2)); // true
        System.out.println("date1 est après date2 : " + date1.isAfter(date2)); // false
        System.out.println("date1 égale date2 : " + date1.equals(date2)); // false


        LocalDateTime dateTime1 = LocalDateTime.of(2023, 10, 26, 10, 0, 0);
        LocalDateTime dateTime2 = LocalDateTime.of(2023, 10, 26, 10, 0, 0);
        System.out.println("dateTime1 égale dateTime2 : " + dateTime1.equals(dateTime2)); //true

    }
}

Les méthodes de l’API java.time (isBefore(), isAfter(), equals()) fournissent des comparaisons claires et non ambiguës, rendant votre code plus lisible et plus maintenable.