Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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