CKTIS / Java
`LocalDate.equals(Object)` — Gleichheit von Datumswerten
Mit `LocalDate.equals` prüfst du, ob zwei `LocalDate`-Werte dasselbe ISO-Datum darstellen. Für denselben Tag in verschiedenen Kalendersystemen verwendest du `isEqual`.
Version: Java SE 21
Syntax
public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);In Java SE 21 liefert die Instanzmethode LocalDate.equals(Object obj) nur dann true, wenn obj ein java.time.LocalDate mit demselben Jahr, Monat und Tag des Monats ist. LocalDate steht für ein ISO-8601-Datum ohne Uhrzeit und Zeitzone, nicht für einen Zeitpunkt.
date.equals(null) liefert false, wenn date nicht null ist. Ist date selbst null, löst date.equals(other) eine NullPointerException aus. Kann eine der beiden Referenzen null sein, verwende Objects.equals(date, other): Bei zweimal null ist das Ergebnis true, bei genau einmal null ist es false.
Der Operator == vergleicht Referenzen, keine Datumswerte. Gleiche LocalDate-Werte haben denselben hashCode(), aber übereinstimmende Hashcodes beweisen keine Gleichheit.
equals liefert für einen anderen Typ false, selbst wenn ein JapaneseDate denselben Tag bezeichnet. Mit isEqual(ChronoLocalDate) vergleichst du die Tageszahl relativ zur Epoche unabhängig vom Kalendersystem; das Argument darf nicht null sein. Zum Sortieren dient compareTo(ChronoLocalDate): Bei demselben Tag entscheidet das Kalendersystem über die Reihenfolge.
Beispiele
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));
}
}Ergebnis
Same ISO date: true Next ISO date: false Null argument: false Different calendar, equals: false Different calendar, isEqual: true Two missing dates: true
`date` und `sameDate` werden auf unterschiedliche Weise erzeugt, haben aber denselben Wert. `japaneseDate` bezeichnet denselben Tag in einem anderen Kalender. Deshalb liefert `equals` den Wert `false` und `isEqual` den Wert `true`.
Zugehörige Lektionen
- Java · Lektion 4 · Fortgeschritten · Version: 2
Quellen
- 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 !=