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
Източници
- 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 !=