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