Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

LocalDate — datum bez vremena i vremenske zone

LocalDate predstavlja nepromjenjiv datum ISO kalendara bez vremena i vremenske zone. Omogućuje stvaranje, pomicanje, uspoređivanje, parsiranje i oblikovanje datuma.

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

Sintaksa

LocalDate.of(year, month, dayOfMonth)
date.plusDays(days)
date.isAfter(other)
date.toString()
date.equals(other)
date.compareTo(other)
date.with(adjuster)
date.with(field, newValue)
date.atTime(hour, minute)
LocalDate.parse(text)
LocalDate.parse(text, formatter)
date.format(formatter)

java.time.LocalDate pohranjuje datum ISO kalendara bez vremena i vremenske zone; sam po sebi ne određuje trenutak na vremenskoj crti. Nepromjenjiv je i siguran za rad u više dretvi. LocalDate.of(year, month, dayOfMonth) stvara datum; mjeseci su numerirani od 1 do 12. Nevažeći datum uzrokuje DateTimeException.

LocalDate.plusDays vraća rezultat dodavanja dana i uzima u obzir granice mjeseci i prijestupne godine; izvorni objekt ostaje nepromijenjen. LocalDate.with(adjuster) primjenjuje pravilo prilagodbe, dok LocalDate.with(field, newValue) postavlja polje. Obrada nevažećeg dana ovisi o polju: promjena mjeseca može ograničiti dan na kraj mjeseca, ali nevažeći DAY_OF_MONTH uzrokuje iznimku.

LocalDate.isAfter provjerava je li datum kasniji. LocalDate.equals uspoređuje vrijednosti datuma tipa LocalDate, a ne identitet objekata — nemojte ga zamijeniti s ==. Za dva objekta LocalDate, LocalDate.compareTo prema redoslijedu datuma vraća negativan broj, nulu ili pozitivan broj; nemojte pretpostaviti da je rezultat točno -1 ili 1.

LocalDate.parse(text) čita datum ISO; preopterećenje s formatterom podržava drugi format. Pogreška pri parsiranju uzrokuje DateTimeParseException. LocalDate.toString vraća tekst ISO, dok LocalDate.format(formatter) upotrebljava zadani formatter. U uzorku dd/MM/uuuu, uuuu označava godinu, a ne godinu ere (yyyy).

LocalDate.atTime(hour, minute) stvara LocalDateTime, i dalje bez vremenske zone; preopterećenje s OffsetTime vraća OffsetDateTime. Primjer upotrebljava fiksne datume i prikazuje 29. veljače 2024. Opseg dokumentacije: Java SE 21; produkcijsko okruženje nije potvrđeno.

Primjeri

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate next = start.plusDays(1);
        LocalDate parsed = LocalDate.parse("2024-02-29");
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");

        System.out.println(start.toString());
        System.out.println(next.toString());
        System.out.println(next.isAfter(start));
        System.out.println(next.equals(parsed));
        System.out.println(start.compareTo(next) < 0);
        System.out.println(start.with(TemporalAdjusters.lastDayOfMonth()));
        System.out.println(next.atTime(9, 30));
        System.out.println(next.format(formatter));
    }
}

Rezultat

2024-02-28
2024-02-29
true
true
true
2024-02-29
2024-02-29T09:30
29/02/2024

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori