Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

LocalDate: tworzenie, przesuwanie, porównywanie i zapis dat

Utwórz datę za pomocą `LocalDate.of`, przesuń ją o dni kalendarzowe, porównaj z inną datą i uzyskaj jej zapis tekstowy w formacie ISO.

Wersja: Java SE 21

Składnia

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 reprezentuje datę kalendarzową ISO bez godziny i strefy czasowej. Statyczna metoda fabryczna LocalDate.of przyjmuje kolejno rok, miesiąc i dzień miesiąca. Miesiąc podaje się jako int od 1 do 12 albo jako niepustą wartość typu Month, np. Month.FEBRUARY. Nieprawidłowa data, np. 29 lutego w roku nieprzestępnym, powoduje zgłoszenie DateTimeException; metoda jej nie koryguje.

date.plusDays(n) przyjmuje liczbę dni kalendarzowych typu long i zwraca wynikową datę, w razie potrzeby przechodząc do innego miesiąca lub roku. Wartość ujemna cofa datę, a zero zachowuje jej wartość. LocalDate jest niemutowalny: wywołanie nie zmienia date, więc zapisz lub od razu wykorzystaj wynik. Jeśli obliczenie nie powoduje przepełnienia, wynik poza obsługiwanym zakresem dat powoduje zgłoszenie DateTimeException, jak przy LocalDate.MAX.plusDays(1). W JDK 21, jeśli pośrednie dodawanie do liczby dni od epoki powoduje przepełnienie typu long, metoda zgłasza ArithmeticException przed sprawdzeniem zakresu dat.

a.isAfter(b) zwraca true tylko wtedy, gdy a jest późniejsza niż b. Dla tej samej daty lub wcześniejszej daty a wynikiem jest false. Parametr ma typ ChronoLocalDate i nie może być null. Metoda porównuje położenie dat na lokalnej osi czasu, nie uwzględniając systemu kalendarzowego.

date.toString() zwraca String w formacie ISO-8601 uuuu-MM-dd, np. 2024-03-01. Metoda sama niczego nie wypisuje ani nie dostosowuje zapisu do ustawień regionalnych. Do zapisu dostosowanego do odbiorcy użyj format z odpowiednim DateTimeFormatter.

Przykłady

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

Wynik

2024-02-28
2024-03-01
true
false

Rok 2024 jest przestępny, więc dwa dni po `2024-02-28` wypada `2024-03-01`. Pierwsza linia pokazuje, że data początkowa się nie zmieniła; dwa ostatnie wiersze pokazują, że wynik jest późniejszy od daty początkowej, ale nie od samego siebie.

Powiązane lekcje

  • Java · Lekcja 68 · Podstawowy · Wersja: 2

Źródła