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.