Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Period — koledarsko obdobje med datumoma

java.time.Period predstavlja obdobje v letih, mesecih in dnevih. Period.between izračuna to obdobje med dvema vrednostma LocalDate, ne pa pretečenega časa v sekundah.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)

java.time.Period je nespremenljiva vrednost, varna za uporabo v večnitnih programih, ki predstavlja leta, mesece in dneve v koledarju ISO. Uporablja se za koledarske izračune; Duration predstavlja čas v sekundah in nanosekundah. Koledarski dan ob spremembi ure ni nujno enak 24 uram.

Period.between(start, end) sprejme dve neničelni vrednosti LocalDate: začetni datum je vključen, končni pa izključen. Izračuna polne mesece in preostale dni, nato pa mesece razdeli na leta in mesece. Zgodnejši končni datum povzroči negativno obdobje.

getDays() vrne samo komponento dni, ne pa skupnega števila dni. V primeru P1Y2M3D pomeni eno leto, dva meseca in tri dni. start.plus(period) ustvari nov datum; vrednosti start ne spremeni.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri