KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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