CKTIS / Java
`LocalDate.equals(Object)` — uguaglianza tra date
Usa `LocalDate.equals` per verificare se due valori `LocalDate` rappresentano la stessa data ISO. Per confrontare lo stesso giorno in calendari diversi, usa `isEqual`.
Versione: Java SE 21
Sintassi
public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);In Java SE 21, il metodo di istanza LocalDate.equals(Object obj) restituisce true solo se obj è un java.time.LocalDate con lo stesso anno, mese e giorno del mese. LocalDate rappresenta una data ISO-8601 senza ora né fuso orario, non un istante.
date.equals(null) restituisce false se date non è null. Se invece date è null, la chiamata date.equals(other) genera una NullPointerException. Se uno dei due riferimenti può essere null, usa Objects.equals(date, other): con entrambi i riferimenti a null ottieni true, con uno solo ottieni false.
L’operatore == confronta i riferimenti, non i valori delle date. Valori LocalDate uguali hanno lo stesso hashCode(), ma avere lo stesso codice hash non dimostra l’uguaglianza.
equals restituisce false per un altro tipo, anche se un JapaneseDate indica lo stesso giorno. Usa isEqual(ChronoLocalDate) per confrontare il numero del giorno rispetto all’epoca di riferimento, senza tener conto del calendario; l’argomento non può essere null. Per ordinare, usa compareTo(ChronoLocalDate): a parità di giorno, il calendario determina l’ordine.
Esempi
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));
}
}Risultato
Same ISO date: true Next ISO date: false Null argument: false Different calendar, equals: false Different calendar, isEqual: true Two missing dates: true
`date` e `sameDate` vengono create in modi diversi, ma hanno lo stesso valore. `japaneseDate` indica lo stesso giorno in un altro calendario, quindi `equals` restituisce `false` e `isEqual` restituisce `true`.
Lezioni correlate
- Java · Lezione 4 · Avanzato · Versione: 2
Fonti
- 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 !=