CKTIS / Java
LocalDate: vytvorenie, posun, porovnanie a zobrazenie dátumov
Vytvorte dátum podľa kalendára ISO, posuňte ho o kalendárne dni bez zmeny pôvodnej hodnoty, porovnajte ho s iným dátumom a získajte jeho textový zápis.
Verzia: Java SE 21
Syntax
import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;
// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()java.time.LocalDate predstavuje dátum v kalendári ISO bez denného času a časového pásma. Statická továrenská metóda LocalDate.of prijíma v tomto poradí rok, mesiac a deň v mesiaci. Mesiac zadajte ako int od 1 do 12 alebo ako hodnotu typu Month rôznu od null, napríklad Month.FEBRUARY. Neplatný dátum, napríklad 29. február v nepriestupnom roku, sa neopraví a metóda vyvolá DateTimeException.
date.plusDays(n) prijíma počet kalendárnych dní typu long a vracia výsledný dátum, podľa potreby aj v inom mesiaci alebo roku. Záporná hodnota posúva dátum späť, nula jeho hodnotu zachováva. LocalDate je nemenný: volanie nezmení date, preto výsledok uložte alebo rovno použite. Ak pri výpočte nedôjde k pretečeniu, ale výsledný dátum je mimo podporovaného rozsahu, metóda vyvolá DateTimeException, napríklad pri LocalDate.MAX.plusDays(1). Ak v JDK 21 pri medzivýpočte pretečie súčet počtu dní od epochy a pripočítavaných dní v type long, metóda vyvolá ArithmeticException ešte pred kontrolou rozsahu dátumov.
a.isAfter(b) vracia true, len ak je a neskorší než b. Ak je a skorší alebo obe hodnoty predstavujú ten istý deň, vráti false. Parameter má typ ChronoLocalDate a b nesmie byť null. Porovnáva sa poloha dátumov na miestnej časovej osi bez ohľadu na ich kalendárne systémy.
date.toString() vracia String vo formáte ISO-8601 uuuu-MM-dd, napríklad 2024-03-01. Metóda nič nevypisuje ani neprispôsobuje text miestnym nastaveniam. Pre formát určený čitateľovi použite format s vhodným DateTimeFormatter.
Príklady
import java.time.LocalDate;
public class Main {
public static void main(String[] args) {
LocalDate start = LocalDate.of(2024, 2, 28);
LocalDate later = start.plusDays(2);
System.out.println(start.toString());
System.out.println(later.toString());
System.out.println(later.isAfter(start));
System.out.println(later.isAfter(later));
}
}Výsledok
2024-02-28 2024-03-01 true false
Rok 2024 je priestupný, takže dva dni po `2024-02-28` nastane `2024-03-01`. Prvý riadok ukazuje, že pôvodný dátum sa nezmenil; posledné dva ukazujú, že výsledok je neskorší než pôvodný dátum, ale nie neskorší než on sám.
Súvisiace lekcie
- Java · Lekcia 68 · Základná · Verzia: 2