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.