CKTIS / Java
ChronoUnit.DAYS.between — dias entre datas
ChronoUnit.DAYS.between(start, end) devolve o número de dias completos como long. Para LocalDate, calcula a diferença entre datas do calendário; se o fim for anterior ao início, o resultado é negativo.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
long days = ChronoUnit.DAYS.between(startInclusive, endExclusive);ChronoUnit.DAYS.between(start, end) devolve um long: o número de dias completos entre objetos temporais compatíveis. O início é incluído e o fim é excluído. A expressão equivalente é start.until(end, ChronoUnit.DAYS).
Para LocalDate, calcula a diferença entre datas do calendário. O exemplo abrange 29 de fevereiro de 2024: de 2024-02-28 a 2024-03-01 são 2 dias, não 3. Inverter estes argumentos dá -2, e datas iguais dão 0.
O significado de um dia completo depende dos tipos dos argumentos. DAYS é uma unidade baseada na data; não assuma que um dia corresponde sempre exatamente a 24 horas, sobretudo nas mudanças para a hora de verão. Os argumentos têm de ser não nulos, compatíveis e suportar esta unidade; uma unidade não suportada provoca UnsupportedTemporalTypeException. O cálculo não altera os argumentos.
Exemplos
import java.time.LocalDate;
import java.time.temporal.ChronoUnit;
public class Main {
public static void main(String[] args) {
LocalDate start = LocalDate.of(2024, 2, 28);
LocalDate end = LocalDate.of(2024, 3, 1);
System.out.println(ChronoUnit.DAYS.between(start, end));
System.out.println(ChronoUnit.DAYS.between(end, start));
System.out.println(ChronoUnit.DAYS.between(start, start));
}
}Resultado
2 -2 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.