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.