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

CKTIS / Java

Period — un período de calendario entre fechas

java.time.Period representa un período en años, meses y días. Period.between calcula ese período entre dos valores LocalDate, no el tiempo transcurrido en segundos.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)

java.time.Period es un valor inmutable y seguro para usar entre hilos que representa años, meses y días en el calendario ISO. Se utiliza para cálculos de calendario; Duration representa tiempo en segundos y nanosegundos. Un día de calendario no tiene por qué equivaler a 24 horas cuando cambia la hora.

Period.between(start, end) acepta dos valores LocalDate no nulos: el inicio se incluye y el final se excluye. Calcula los meses completos y los días restantes y, después, desglosa los meses en años y meses. Una fecha final anterior produce un período negativo.

getDays() devuelve solo el componente de días, no el número total de días. En el ejemplo, P1Y2M3D significa un año, dos meses y tres días. start.plus(period) crea una fecha nueva; no modifica start.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes