CKTIS / Java
`LocalDate.equals(Object)` — igualdad de fechas
Usa `LocalDate.equals` para comprobar si dos valores `LocalDate` representan la misma fecha ISO. Para comparar el mismo día en distintos calendarios, usa `isEqual`.
Versión: Java SE 21
Sintaxis
public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);En Java SE 21, el método de instancia LocalDate.equals(Object obj) devuelve true solo si obj es un java.time.LocalDate con el mismo año, mes y día del mes. LocalDate representa una fecha ISO-8601 sin hora ni zona horaria, no un instante.
date.equals(null) devuelve false si date no es null. Si date es null, llamar a date.equals(other) lanza NullPointerException. Si cualquiera de las referencias puede ser null, usa Objects.equals(date, other): dos referencias null dan true y exactamente una da false.
El operador == compara referencias, no valores de fecha. Dos valores LocalDate iguales tienen el mismo hashCode(), pero dos códigos hash iguales no demuestran que las fechas sean iguales.
equals devuelve false para otro tipo, aunque un JapaneseDate represente el mismo día. Usa isEqual(ChronoLocalDate) para comparar el número de día relativo a la época de referencia sin tener en cuenta el calendario; el argumento no puede ser null. Para ordenar, usa compareTo(ChronoLocalDate): si el día coincide, el calendario determina el orden.
Ejemplos
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` y `sameDate` se crean de formas distintas, pero tienen el mismo valor. `japaneseDate` representa el mismo día en otro calendario, por lo que `equals` devuelve `false` e `isEqual` devuelve `true`.
Lecciones relacionadas
- Java · Lección 4 · Avanzado · Versión: 2
Fuentes
- 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 !=