CKTIS / Java
`LocalDate.equals(Object)` — gelijkheid van datums
Gebruik `LocalDate.equals` om te controleren of twee `LocalDate`-waarden dezelfde ISO-datum voorstellen. Vergelijk dezelfde dag in verschillende kalenders met `isEqual`.
Versie: Java SE 21
Syntax
public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);In Java SE 21 geeft de instantiemethode LocalDate.equals(Object obj) alleen true terug als obj een java.time.LocalDate is met hetzelfde jaar, dezelfde maand en dezelfde dag van de maand. LocalDate stelt een ISO-8601-datum zonder tijdstip of tijdzone voor, geen moment op de tijdlijn.
date.equals(null) geeft false terug als date niet null is. Als date zelf null is, veroorzaakt date.equals(other) een NullPointerException. Als een van beide referenties null kan zijn, gebruik dan Objects.equals(date, other): het resultaat is true als beide null zijn en false als er precies één null is.
De operator == vergelijkt referenties, niet datumwaarden. Gelijke LocalDate-waarden hebben dezelfde hashCode(), maar gelijke hashcodes bewijzen geen gelijkheid.
equals geeft false terug voor een ander type, zelfs als een JapaneseDate dezelfde dag aanduidt. Gebruik isEqual(ChronoLocalDate) om het dagnummer ten opzichte van de referentie-epoch te vergelijken, ongeacht het kalendersysteem; het argument mag niet null zijn. Gebruik compareTo(ChronoLocalDate) om te sorteren: bij dezelfde dag bepaalt het kalendersysteem de volgorde.
Voorbeelden
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));
}
}Resultaat
Same ISO date: true Next ISO date: false Null argument: false Different calendar, equals: false Different calendar, isEqual: true Two missing dates: true
`date` en `sameDate` worden op verschillende manieren gemaakt, maar hebben dezelfde waarde. `japaneseDate` duidt dezelfde dag aan in een andere kalender, waardoor `equals` `false` en `isEqual` `true` teruggeeft.
Gerelateerde lessen
- Java · Les 4 · Gevorderd · Versie: 2
Bronnen
- 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 !=