Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

LocalDate.compareTo: ordenar encomendas apenas pela data

Usa o sinal do resultado de `LocalDate.compareTo` para ordenar datas. Ao ordenar apenas pela data, as encomendas do mesmo dia são equivalentes na comparação, mesmo que tenham títulos diferentes.

Versão: Java SE 21

Sintaxe

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

O método de instância LocalDate.compareTo recebe um argumento do tipo java.time.chrono.ChronoLocalDate, pelo que podes passar-lhe outro LocalDate. Um java.time.LocalDate representa uma data ISO sem hora nem fuso horário.

Para dois valores LocalDate, um resultado < 0 significa que a data do objeto sobre o qual chamaste o método é anterior, == 0 indica a mesma data e > 0 indica uma data posterior. Verifica o sinal: um resultado diferente de zero não tem de ser -1 ou 1 e não indica um número de dias. Passar null lança uma NullPointerException.

Ao comparar datas de calendários diferentes, compareTo compara primeiro os dias na linha temporal local. Se representarem o mesmo dia, o identificador da cronologia desempata. Usa isEqual para testar se é o mesmo dia, independentemente da cronologia.

No exemplo, Order.compareTo compara apenas date; title não serve para desempatar. Duas encomendas com a mesma data mas títulos diferentes dão 0, embora o método equals gerado para o record devolva false. Um TreeSet que use esta ordem natural não guarda, portanto, ambas como elementos distintos.

Exemplos

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

Resultado

-1
1
0
false

`Integer.signum` normaliza os resultados para `-1`, `1` e `0`: antes, depois e no mesmo dia. O `false` final diz respeito à igualdade dos records, não à ordem das datas.

Lições relacionadas

  • Java · Lição 11 · Avançado · Versão: 2

Fontes