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

CKTIS / Java

Period.between: anos, meses, dias e total de dias

Calcula o período de calendário entre duas datas e lê as suas componentes. Se precisares do número total de dias, calcula-o diretamente a partir das datas.

Versão: Java SE 21

Sintaxe

import java.time.LocalDate;
import java.time.Period;
import java.time.temporal.ChronoUnit;

// start and end are LocalDate values.
Period period = Period.between(start, end);
int years = period.getYears();
int months = period.getMonths();
int days = period.getDays();
long totalDays = ChronoUnit.DAYS.between(start, end);

O método estático Period.between(start, end) de java.time.Period recebe dois valores LocalDate, sem hora nem fuso horário. A data inicial é incluída e a data final é excluída. O método determina os meses completos e os dias que sobram e, depois, decompõe os meses completos em anos de 12 meses e meses restantes.

Os métodos getYears(), getMonths() e getDays() devolvem, respetivamente, as componentes de anos, meses e dias, todas do tipo int. No resultado de between, a componente dos meses não inclui os meses já contados como anos, e a dos dias contém apenas os dias que sobram depois de contar os meses completos. Se as datas forem iguais, as três componentes são zero. Se a data final for anterior à inicial, todas as componentes diferentes de zero são negativas.

Para obter o número total de dias de calendário, usa ChronoUnit.DAYS.between(start, end) do pacote java.time.temporal. Devolve um long, exclui a data final e dá um resultado negativo se o fim for anterior ao início. Não convertas as componentes de Period assumindo um número fixo de dias por mês ou por ano: a sua duração varia consoante o calendário.

Exemplos

import java.time.LocalDate;
import java.time.Period;
import java.time.temporal.ChronoUnit;

public class PeriodExample {
    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);
        long totalDays = ChronoUnit.DAYS.between(start, end);

        System.out.println("years=" + period.getYears());
        System.out.println("months=" + period.getMonths());
        System.out.println("days=" + period.getDays());
        System.out.println("totalDays=" + totalDays);
    }
}

Resultado

years=1
months=2
days=3
totalDays=428

De `2023-01-15` a `2024-03-18`, o período é de 1 ano, 2 meses e 3 dias. Por isso, `getDays()` devolve `3`, enquanto `ChronoUnit.DAYS.between(start, end)` devolve `428`.

Lições relacionadas

  • Java · Lição 68 · Básico · Versão: 2

Fontes