Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

`LocalDate.equals(Object)` — rovnost kalendářních dat

Pomocí `LocalDate.equals` zjistíš, zda dvě hodnoty `LocalDate` představují stejné datum ISO. Pro porovnání téhož dne v různých kalendářích použij `isEqual`.

Verze: Java SE 21

Syntaxe

public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);

V Java SE 21 vrací instanční metoda LocalDate.equals(Object obj) hodnotu true pouze tehdy, když je obj typu java.time.LocalDate a má stejný rok, měsíc i den v měsíci. LocalDate představuje datum ISO-8601 bez denní doby a časového pásma, nikoli okamžik.

date.equals(null) vrací false, pokud date není null. Pokud je samotné date rovno null, volání date.equals(other) vyvolá výjimku NullPointerException. Pokud může být kterákoli z referencí null, použij Objects.equals(date, other): dvě hodnoty null dají true, právě jedna dá false.

Operátor == porovnává reference, nikoli hodnoty dat. Shodné hodnoty LocalDate mají stejný hashCode(), ale shoda hash kódů nedokazuje rovnost hodnot.

equals vrací pro jiný typ false, i když JapaneseDate označuje stejný den. Pomocí isEqual(ChronoLocalDate) porovnáš číslo dne vzhledem k referenční epoše bez ohledu na kalendář; argument nesmí být null. K řazení použij compareTo(ChronoLocalDate): při shodě dne určuje pořadí kalendářní systém.

Příklady

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));
    }
}

Výsledek

Same ISO date: true
Next ISO date: false
Null argument: false
Different calendar, equals: false
Different calendar, isEqual: true
Two missing dates: true

`date` a `sameDate` vznikají různými způsoby, ale mají stejnou hodnotu. `japaneseDate` označuje stejný den v jiném kalendáři, proto `equals` vrací `false`, zatímco `isEqual` vrací `true`.

Související lekce

  • Java · Lekce 4 · Pokročilá · Verze: 2

Zdroje