CKTIS / Java
`LocalDate.equals(Object)` — égalité de dates
Utilisez `LocalDate.equals` pour vérifier si deux valeurs `LocalDate` représentent la même date ISO. Pour comparer le même jour entre calendriers, utilisez `isEqual`.
Version : Java SE 21
Syntaxe
public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);Dans Java SE 21, la méthode d’instance LocalDate.equals(Object obj) renvoie true uniquement si obj est un java.time.LocalDate dont l’année, le mois et le jour du mois sont identiques. LocalDate représente une date ISO-8601 sans heure ni fuseau horaire, et non un instant.
date.equals(null) renvoie false si date n’est pas null. Si date vaut elle-même null, l’appel date.equals(other) lève une NullPointerException. Si l’une ou l’autre des références peut être null, utilisez Objects.equals(date, other) : deux références null donnent true, une seule donne false.
L’opérateur == compare les références, pas les valeurs des dates. Deux valeurs LocalDate égales ont le même hashCode(), mais des codes de hachage identiques ne prouvent pas l’égalité.
equals renvoie false pour un autre type, même si un JapaneseDate désigne le même jour. Utilisez isEqual(ChronoLocalDate) pour comparer le numéro de jour par rapport à l’époque de référence, sans tenir compte du calendrier ; l’argument ne doit pas être null. Pour le tri, utilisez compareTo(ChronoLocalDate) : à jour identique, le système de calendrier détermine l’ordre.
Exemples
import java.time.LocalDate;
import java.time.chrono.JapaneseDate;
import java.util.Objects;
public class Main {
public static void main(String[] args) {
LocalDate date = LocalDate.of(2024, 2, 29);
LocalDate sameDate = LocalDate.parse("2024-02-29");
LocalDate nextDate = date.plusDays(1);
JapaneseDate japaneseDate = JapaneseDate.from(date);
LocalDate missing = null;
System.out.println("Same ISO date: " + date.equals(sameDate));
System.out.println("Next ISO date: " + date.equals(nextDate));
System.out.println("Null argument: " + date.equals(null));
System.out.println("Different calendar, equals: " + date.equals(japaneseDate));
System.out.println("Different calendar, isEqual: " + date.isEqual(japaneseDate));
System.out.println("Two missing dates: " + Objects.equals(missing, missing));
}
}Résultat
Same ISO date: true Next ISO date: false Null argument: false Different calendar, equals: false Different calendar, isEqual: true Two missing dates: true
`date` et `sameDate` sont créées de deux façons différentes, mais ont la même valeur. `japaneseDate` désigne le même jour dans un autre calendrier : `equals` renvoie donc `false`, tandis que `isEqual` renvoie `true`.
Leçons associées
- Java · Leçon 4 · Avancé · Version : 2
Sources
- Java SE 21 API — LocalDate.equals(Object)
- Java SE 21 API — LocalDate
- Java SE 21 API — ChronoLocalDate.isEqual(ChronoLocalDate)
- Java SE 21 API — Objects.equals(Object, Object)
- Java SE 21 API — Object.hashCode()
- Java SE 21 API — JapaneseDate.from(TemporalAccessor)
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators == and !=