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

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.

Fontes