Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes