Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

`LocalDate.equals(Object)` — równość dat

Użyj `LocalDate.equals`, aby sprawdzić, czy dwie wartości `LocalDate` oznaczają tę samą datę ISO. Do porównania dnia w różnych kalendarzach służy `isEqual`.

Wersja: Java SE 21

Składnia

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

W Java SE 21 metoda instancji LocalDate.equals(Object obj) zwraca true tylko wtedy, gdy obj jest obiektem java.time.LocalDate z tym samym rokiem, miesiącem i dniem miesiąca. LocalDate reprezentuje datę ISO-8601 bez godziny i strefy czasowej, a nie moment w czasie.

date.equals(null) zwraca false, jeśli date nie jest null. Jeśli sama zmienna date ma wartość null, wywołanie date.equals(other) kończy się wyjątkiem NullPointerException. Gdy obie referencje mogą być null, użyj Objects.equals(date, other): dwa null dają true, a dokładnie jeden daje false.

Operator == porównuje referencje, nie wartości dat. Równe wartości LocalDate mają ten sam hashCode(), ale zgodność kodów skrótu nie dowodzi równości.

equals zwraca false dla innego typu, nawet gdy JapaneseDate oznacza ten sam dzień. Użyj isEqual(ChronoLocalDate), aby porównać numer dnia względem epoki bez uwzględniania kalendarza; argument nie może być null. Do sortowania służy compareTo(ChronoLocalDate), które dla tego samego dnia rozstrzyga kolejność na podstawie kalendarza.

Przykłady

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

Wynik

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

`date` i `sameDate` powstają w różny sposób, ale mają tę samą wartość. `japaneseDate` oznacza ten sam dzień w innym kalendarzu, dlatego `equals` zwraca `false`, a `isEqual` zwraca `true`.

Powiązane lekcje

  • Java · Lekcja 4 · Zaawansowany · Wersja: 2

Źródła