CKTIS / Java
`LocalDate.equals(Object)` — igualdade de datas
Usa `LocalDate.equals` para verificar se dois valores `LocalDate` representam a mesma data ISO. Para comparar o mesmo dia em calendários diferentes, usa `isEqual`.
Versão: Java SE 21
Sintaxe
public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);Em Java SE 21, o método de instância LocalDate.equals(Object obj) devolve true apenas se obj for um java.time.LocalDate com o mesmo ano, mês e dia do mês. LocalDate representa uma data ISO-8601 sem hora nem fuso horário, não um instante.
date.equals(null) devolve false se date não for null. Se a própria referência date for null, a chamada date.equals(other) lança NullPointerException. Se qualquer uma das referências puder ser null, usa Objects.equals(date, other): devolve true se ambas forem null e false se apenas uma for null.
O operador == compara referências, não os valores das datas. Valores LocalDate iguais têm o mesmo hashCode(), mas códigos hash iguais não provam a igualdade.
equals devolve false para outro tipo, mesmo que um JapaneseDate represente o mesmo dia. Usa isEqual(ChronoLocalDate) para comparar o número do dia em relação à época de referência, sem ter em conta o calendário; o argumento não pode ser null. Para ordenar, usa compareTo(ChronoLocalDate): se o dia coincidir, o calendário determina a ordem.
Exemplos
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));
}
}Resultado
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` são criadas de formas diferentes, mas têm o mesmo valor. `japaneseDate` representa o mesmo dia noutro calendário, por isso `equals` devolve `false` e `isEqual` devolve `true`.
Lições relacionadas
- Java · Lição 4 · Avançado · Versão: 2
Fontes
- 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 !=