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

CKTIS / Java

Period — um período de calendário entre datas

java.time.Period representa um período em anos, meses e dias. Period.between calcula esse período entre dois valores LocalDate, e não o tempo decorrido em segundos.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)

java.time.Period é um valor imutável e seguro para utilização concorrente que representa anos, meses e dias no calendário ISO. Utilize-o para cálculos de calendário; Duration representa o tempo em segundos e nanossegundos. Um dia de calendário não tem necessariamente 24 horas quando ocorre uma mudança da hora.

Period.between(start, end) aceita dois valores LocalDate não nulos: o início é incluído e o fim é excluído. Calcula os meses completos e os dias restantes e, em seguida, divide os meses em anos e meses. Uma data final anterior resulta num período negativo.

getDays() devolve apenas a componente dos dias, não o número total de dias. No exemplo, P1Y2M3D significa um ano, dois meses e três dias. start.plus(period) cria uma nova data; não altera start.

Exemplos

import java.time.LocalDate;
import java.time.Period;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2023, 1, 15);
        LocalDate end = LocalDate.of(2024, 3, 18);
        Period period = Period.between(start, end);

        System.out.println(period);
        System.out.println(period.getDays());
        System.out.println(start.plus(period));
    }
}

Resultado

P1Y2M3D
3
2024-03-18

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