Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

`LocalDate.equals(Object)` — rovnosť dátumov

Pomocou `LocalDate.equals` zistíš, či dve hodnoty `LocalDate` predstavujú rovnaký dátum ISO. Na porovnanie toho istého dňa v rôznych kalendároch použi `isEqual`.

Verzia: Java SE 21

Syntax

public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);

V Java SE 21 vracia inštančná metóda LocalDate.equals(Object obj) hodnotu true len vtedy, ak je obj typu java.time.LocalDate a má rovnaký rok, mesiac aj deň v mesiaci. LocalDate predstavuje dátum ISO-8601 bez času dňa a časového pásma, nie okamih.

date.equals(null) vracia false, ak date nie je null. Ak je samotné date rovné null, volanie date.equals(other) vyvolá výnimku NullPointerException. Ak ktorákoľvek z referencií môže byť null, použi Objects.equals(date, other): dve hodnoty null dajú true, práve jedna dá false.

Operátor == porovnáva referencie, nie hodnoty dátumov. Rovnaké hodnoty LocalDate majú rovnaký hashCode(), ale zhoda hašovacích kódov nedokazuje rovnosť.

equals vracia pre iný typ false, aj keď JapaneseDate označuje ten istý deň. Pomocou isEqual(ChronoLocalDate) porovnáš číslo dňa vzhľadom na referenčnú epochu bez ohľadu na kalendár; argument nesmie byť null. Na zoradenie použi compareTo(ChronoLocalDate): pri zhode dňa určuje poradie kalendárny systém.

Príklady

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));
    }
}

Výsledok

Same ISO date: true
Next ISO date: false
Null argument: false
Different calendar, equals: false
Different calendar, isEqual: true
Two missing dates: true

`date` a `sameDate` vznikajú rôznymi spôsobmi, ale majú rovnakú hodnotu. `japaneseDate` označuje ten istý deň v inom kalendári, preto `equals` vracia `false`, zatiaľ čo `isEqual` vracia `true`.

Súvisiace lekcie

  • Java · Lekcia 4 · Pokročilá · Verzia: 2

Zdroje