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
- 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 !=