CKTIS / Java
Period — kalendarsko razdoblje između datuma
java.time.Period predstavlja razdoblje u godinama, mjesecima i danima. Period.between izračunava to razdoblje između dviju vrijednosti LocalDate, a ne proteklo vrijeme u sekundama.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)java.time.Period nepromjenjiva je vrijednost sigurna za višedretvenu uporabu koja predstavlja godine, mjesece i dane u ISO kalendaru. Upotrebljava se za kalendarske izračune; Duration predstavlja vrijeme u sekundama i nanosekundama. Kalendarski dan ne mora odgovarati 24 sata pri promjeni vremena.
Period.between(start, end) prihvaća dvije vrijednosti LocalDate koje nisu null: početni datum uključuje se, a završni isključuje. Izračunava pune mjesece i preostale dane, a zatim mjesece razdvaja na godine i mjesece. Raniji završni datum daje negativno razdoblje.
getDays() vraća samo komponentu dana, a ne ukupan broj dana. U primjeru P1Y2M3D znači jednu godinu, dva mjeseca i tri dana. start.plus(period) stvara novi datum; ne mijenja start.
Primjeri
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));
}
}Rezultat
P1Y2M3D 3 2024-03-18
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.