WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

LocalDate.compareTo: Bestellungen nur nach Datum ordnen

Das Vorzeichen von `LocalDate.compareTo` gibt die Reihenfolge der Datumswerte an. Werden Bestellungen nur nach Datum geordnet, sind Bestellungen vom selben Tag im Vergleich gleich, auch wenn ihre Titel verschieden sind.

Version: Java SE 21

Syntax

import java.time.LocalDate;
import java.time.chrono.ChronoLocalDate;

// Instance method declared by LocalDate:
public int compareTo(ChronoLocalDate other)

// Call with a LocalDate receiver and a non-null ChronoLocalDate argument:
int result = date.compareTo(other);

Die Instanzmethode LocalDate.compareTo erwartet ein Argument vom Typ java.time.chrono.ChronoLocalDate. Du kannst also auch ein weiteres LocalDate übergeben. Ein java.time.LocalDate steht für ein ISO-Datum ohne Uhrzeit und Zeitzone.

Bei zwei LocalDate-Werten bedeutet < 0, dass das Datum des aufrufenden Objekts früher liegt, == 0 steht für dasselbe Datum und > 0 für ein späteres Datum. Prüfe das Vorzeichen: Ein Ergebnis ungleich null muss weder -1 noch 1 sein und gibt keine Anzahl von Tagen an. Bei null als Argument wird eine NullPointerException ausgelöst.

Bei Datumswerten aus verschiedenen Kalendersystemen vergleicht compareTo zuerst die Tage auf der lokalen Zeitachse. Stehen beide Werte für denselben Tag, entscheidet die Chronologie-ID. Mit isEqual prüfst du unabhängig von der Chronologie, ob es derselbe Tag ist.

Im Beispiel vergleicht Order.compareTo nur date; title entscheidet bei Gleichstand nicht mit. Für zwei Bestellungen mit demselben Datum und verschiedenen Titeln liefert der Vergleich 0, obwohl die generierte equals-Methode des Records false liefert. Ein TreeSet mit dieser natürlichen Ordnung speichert daher nicht beide als separate Elemente.

Beispiele

import java.time.LocalDate;

public class Main {
    record Order(LocalDate date, String title) implements Comparable<Order> {
        @Override
        public int compareTo(Order other) {
            return date.compareTo(other.date());
        }
    }

    public static void main(String[] args) {
        var first = new Order(LocalDate.of(2025, 4, 2), "Zebra");
        var later = new Order(LocalDate.of(2025, 4, 5), "Alpha");
        var sameDay = new Order(LocalDate.of(2025, 4, 2), "Beta");

        System.out.println(Integer.signum(first.compareTo(later)));
        System.out.println(Integer.signum(later.compareTo(first)));
        System.out.println(Integer.signum(first.compareTo(sameDay)));
        System.out.println(first.equals(sameDay));
    }
}

Ergebnis

-1
1
0
false

`Integer.signum` normiert die Vergleichsergebnisse auf `-1`, `1` und `0`: früher, später und am selben Tag. Das abschließende `false` betrifft die Gleichheit der Records, nicht die Reihenfolge der Datumswerte.

Zugehörige Lektionen

  • Java · Lektion 11 · Fortgeschritten · Version: 2

Quellen