Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

LocalDate: stvaranje, pomicanje, uspoređivanje i prikaz datuma

Stvori datum u kalendaru ISO, pomakni ga za kalendarske dane bez promjene izvornika, usporedi ga s drugim datumom i dohvati njegov tekstualni zapis.

Verzija: Java SE 21

Sintaksa

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 predstavlja datum u kalendaru ISO bez doba dana i vremenske zone. Statička tvornička metoda LocalDate.of prima godinu, mjesec i dan u mjesecu tim redoslijedom. Mjesec zadaj kao int od 1 do 12 ili kao vrijednost tipa Month koja nije null, primjerice Month.FEBRUARY. Neispravan datum, poput 29. veljače u neprijestupnoj godini, ne ispravlja se, nego metoda baca DateTimeException.

date.plusDays(n) prima broj kalendarskih dana tipa long i vraća izračunani datum, po potrebi u drugom mjesecu ili godini. Negativna vrijednost pomiče datum unatrag, a nula zadržava njegovu vrijednost. LocalDate je nepromjenjiv: poziv ne mijenja date, stoga spremi ili upotrijebi vraćenu vrijednost. Ako pri izračunu ne dođe do preljeva, ali je rezultat izvan podržanog raspona datuma, metoda baca DateTimeException, primjerice pri LocalDate.MAX.plusDays(1). Ako u JDK-u 21 međuzbroj broja dana od epohe i dodanih dana izađe iz raspona tipa long, metoda baca ArithmeticException prije provjere raspona datuma.

a.isAfter(b) vraća true samo ako je a kasniji od b. Ako je a raniji ili oba predstavljaju isti dan, vraća false. Parametar je tipa ChronoLocalDate i b ne smije biti null. Uspoređuju se položaji datuma na lokalnoj vremenskoj crti, neovisno o njihovim kalendarskim sustavima.

date.toString() vraća String u formatu ISO-8601 uuuu-MM-dd, primjerice 2024-03-01. Metoda ništa ne ispisuje i ne prilagođava tekst regionalnim postavkama. Za format prilagođen čitatelju upotrijebi format s odgovarajućim DateTimeFormatter.

Primjeri

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

Rezultat

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

Godina 2024. je prijestupna, pa je dva dana nakon `2024-02-28` datum `2024-03-01`. Prvi redak pokazuje da je početni datum ostao nepromijenjen; zadnja dva pokazuju da je rezultat kasniji od početnog datuma, ali ne i od samoga sebe.

Povezane lekcije

  • Java · Lekcija 68 · Osnovno · Verzija: 2

Izvori