CKTIS / Java
Period.between: años, meses, días y total de días
Calcula el período de calendario entre dos fechas y lee sus componentes. Si necesitas el número total de días, calcúlalo directamente a partir de las fechas.
Versión: Java SE 21
Sintaxis
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);El método estático Period.between(start, end) de java.time.Period recibe dos valores LocalDate, sin hora ni zona horaria. La fecha inicial se incluye y la final se excluye. El método calcula los meses completos y los días restantes, y después descompone los meses completos en años de 12 meses y meses sobrantes.
Los métodos getYears(), getMonths() y getDays() devuelven los componentes de años, meses y días, respectivamente, todos de tipo int. En el resultado de between, el componente de meses no incluye los meses ya contados como años, y el de días contiene solo los que quedan después de contar los meses completos. Si las fechas son iguales, los tres componentes valen cero. Si la fecha final es anterior a la inicial, cada componente distinto de cero es negativo.
Para obtener el número total de días naturales, usa ChronoUnit.DAYS.between(start, end) del paquete java.time.temporal. Devuelve un long, excluye la fecha final y da un resultado negativo si el final es anterior al inicio. No conviertas los componentes de Period suponiendo un número fijo de días por mes o por año: su duración varía según el calendario.
Ejemplos
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
Del `2023-01-15` al `2024-03-18`, el período es de 1 año, 2 meses y 3 días. Por eso `getDays()` devuelve `3`, mientras que `ChronoUnit.DAYS.between(start, end)` devuelve `428`.
Lecciones relacionadas
- Java · Lección 68 · Básico · Versión: 2