Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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