Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Period — un periodo di calendario tra date

java.time.Period rappresenta un periodo espresso in anni, mesi e giorni. Period.between calcola tale periodo tra due valori LocalDate, non il tempo trascorso in secondi.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)

java.time.Period è un valore immutabile e sicuro per l’uso concorrente, che rappresenta anni, mesi e giorni nel calendario ISO. Si usa per i calcoli di calendario; Duration rappresenta il tempo in secondi e nanosecondi. In caso di cambio dell’ora, un giorno di calendario non deve necessariamente corrispondere a 24 ore.

Period.between(start, end) accetta due valori LocalDate non nulli: l’inizio è incluso e la fine è esclusa. Calcola i mesi interi e i giorni rimanenti, poi suddivide i mesi in anni e mesi. Una data finale precedente produce un periodo negativo.

getDays() restituisce solo la componente dei giorni, non il numero totale di giorni. Nell’esempio, P1Y2M3D significa un anno, due mesi e tre giorni. start.plus(period) crea una nuova data; non modifica start.

Esempi

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));
    }
}

Risultato

P1Y2M3D
3
2024-03-18

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti