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
- LocalDate (Java SE 21 & JDK 21) — compareTo
- ChronoLocalDate (Java SE 21 & JDK 21) — compareTo
- Comparable (Java SE 21 & JDK 21)
- Record (Java SE 21 & JDK 21) — equals
- TreeSet (Java SE 21 & JDK 21)
- Integer (Java SE 21 & JDK 21) — signum
- The java Command — Using Source-File Mode to Launch Single-File Source-Code Programs