Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Period.between: anni, mesi, giorni e giorni totali

Calcola il periodo di calendario tra due date e leggi le sue componenti. Se ti serve il numero totale di giorni, calcolalo direttamente dalle date.

Versione: Java SE 21

Sintassi

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

Il metodo statico Period.between(start, end) di java.time.Period accetta due valori LocalDate, privi di ora e fuso orario. La data iniziale è inclusa e quella finale è esclusa. Il metodo determina i mesi interi e i giorni rimanenti, poi scompone i mesi interi in anni da 12 mesi e mesi residui.

I metodi getYears(), getMonths() e getDays() restituiscono rispettivamente le componenti di anni, mesi e giorni, ciascuna di tipo int. Nel risultato di between, la componente dei mesi non include quelli già conteggiati come anni, mentre quella dei giorni contiene solo i giorni rimasti dopo aver contato i mesi interi. Con due date uguali, tutte e tre le componenti sono zero. Se la data finale precede quella iniziale, ogni componente diversa da zero è negativa.

Per ottenere il numero totale di giorni di calendario, usa ChronoUnit.DAYS.between(start, end) del pacchetto java.time.temporal. Restituisce un long, esclude la data finale e dà un risultato negativo se la fine precede l’inizio. Non convertire le componenti di Period ipotizzando un numero fisso di giorni per mese o per anno: la loro durata varia con il calendario.

Esempi

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

Risultato

years=1
months=2
days=3
totalDays=428

Dal `2023-01-15` al `2024-03-18` il periodo è di 1 anno, 2 mesi e 3 giorni. Quindi `getDays()` restituisce `3`, mentre `ChronoUnit.DAYS.between(start, end)` restituisce `428`.

Lezioni correlate

  • Java · Lezione 68 · Base · Versione: 2

Fonti