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