CKTIS / Java
`LocalDate.equals(Object)` — enakost datumov
Z `LocalDate.equals` preveriš, ali dve vrednosti `LocalDate` predstavljata isti datum ISO. Za primerjavo istega dne v različnih koledarjih uporabi `isEqual`.
Različica: Java SE 21
Sintaksa
public boolean equals(Object obj)
// Instance method of java.time.LocalDate
boolean sameDate = date.equals(other);V Java SE 21 metoda primerka LocalDate.equals(Object obj) vrne true le, če je obj tipa java.time.LocalDate ter ima isto leto, mesec in dan v mesecu. LocalDate predstavlja datum ISO-8601 brez ure in časovnega pasu, ne pa trenutka na časovnici.
date.equals(null) vrne false, če date ni null. Če je date sam null, klic date.equals(other) sproži izjemo NullPointerException. Če je lahko katera koli od referenc null, uporabi Objects.equals(date, other): dve vrednosti null dasta true, natanko ena pa false.
Operator == primerja reference, ne vrednosti datumov. Enaki vrednosti LocalDate imata enak hashCode(), vendar ujemanje zgoščenih kod ne dokazuje enakosti.
equals za drug tip vrne false, tudi če JapaneseDate označuje isti dan. Z isEqual(ChronoLocalDate) primerjaš številko dneva glede na referenčno epoho ne glede na koledar; argument ne sme biti null. Za razvrščanje uporabi compareTo(ChronoLocalDate): če gre za isti dan, vrstni red določi koledarski sistem.
Primeri
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));
}
}Rezultat
Same ISO date: true Next ISO date: false Null argument: false Different calendar, equals: false Different calendar, isEqual: true Two missing dates: true
`date` in `sameDate` sta ustvarjena na različna načina, vendar imata isto vrednost. `japaneseDate` označuje isti dan v drugem koledarju, zato `equals` vrne `false`, `isEqual` pa `true`.
Povezane lekcije
- Java · Lekcija 4 · Napredna · Različica: 2
Viri
- 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 !=