База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

`LocalDate.equals(Object)` — равенство на дати

Използвай `LocalDate.equals`, за да провериш дали две стойности `LocalDate` представляват една и съща дата по ISO. За сравнение на деня в различни календари използвай `isEqual`.

Версия: Java SE 21

Синтаксис

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

В Java SE 21 методът на екземпляра LocalDate.equals(Object obj) връща true само ако obj е от тип java.time.LocalDate и има същата година, месец и ден от месеца. LocalDate представлява дата по ISO-8601 без час и часова зона, а не момент от времевата линия.

date.equals(null) връща false, ако date не е null. Ако самата референция date е null, извикването на date.equals(other) хвърля NullPointerException. Ако някоя от двете референции може да е null, използвай Objects.equals(date, other): при две стойности null резултатът е true, а при точно една — false.

Операторът == сравнява референциите, а не стойностите на датите. Равните стойности LocalDate имат еднакъв hashCode(), но еднаквите хеш кодове не доказват равенство.

equals връща false за друг тип, дори когато JapaneseDate обозначава същия ден. Използвай isEqual(ChronoLocalDate), за да сравниш номера на деня спрямо референтната епоха, независимо от календара; аргументът не трябва да е null. За сортиране използвай compareTo(ChronoLocalDate): при един и същ ден календарната система определя реда.

Примери

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

Резултат

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

`date` и `sameDate` са създадени по различни начини, но имат една и съща стойност. `japaneseDate` обозначава същия ден в друг календар, затова `equals` връща `false`, а `isEqual` връща `true`.

Свързани уроци

  • Java · Урок 4 · Напреднало · Версия: 2

Източници