Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Period — kalendářní období mezi daty

java.time.Period představuje období v letech, měsících a dnech. Period.between toto období vypočítá mezi dvěma hodnotami LocalDate, nikoli jako uplynulý čas v sekundách.

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

Syntaxe

Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)

java.time.Period je neměnná, vláknově bezpečná hodnota, která představuje roky, měsíce a dny v kalendáři ISO. Používá se pro kalendářní výpočty; Duration představuje čas v sekundách a nanosekundách. Kalendářní den nemusí při změně času odpovídat 24 hodinám.

Period.between(start, end) přijímá dvě nenulové hodnoty LocalDate: počáteční datum se započítává, koncové nikoli. Vypočítá celé měsíce a zbývající dny a potom rozdělí měsíce na roky a měsíce. Dřívější koncové datum vede k zápornému období.

getDays() vrací pouze složku dnů, nikoli celkový počet dnů. V příkladu P1Y2M3D znamená jeden rok, dva měsíce a tři dny. start.plus(period) vytvoří nové datum; hodnotu start nezmění.

Příklady

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

Výsledek

P1Y2M3D
3
2024-03-18

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje