Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

LocalDate — datum brez časa in časovnega pasu

LocalDate predstavlja nespremenljiv datum koledarja ISO brez časa in časovnega pasu. Omogoča ustvarjanje, premikanje, primerjanje, razčlenjevanje in oblikovanje datumov.

Različica: 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 hrani datum koledarja ISO brez časa in časovnega pasu; sam po sebi ne določa trenutka na časovnici. Je nespremenljiv in varen za uporabo v večnitnem okolju. LocalDate.of(year, month, dayOfMonth) ustvari datum; meseci so oštevilčeni od 1 do 12. Neveljaven datum povzroči DateTimeException.

LocalDate.plusDays vrne rezultat prištevanja dni ter upošteva meje mesecev in prestopna leta; izvirni objekt ostane nespremenjen. LocalDate.with(adjuster) uporabi pravilo prilagoditve, LocalDate.with(field, newValue) pa nastavi polje. Obravnava neveljavnega dne je odvisna od polja: sprememba meseca lahko dan omeji na zadnji dan meseca, neveljaven DAY_OF_MONTH pa povzroči izjemo.

LocalDate.isAfter preveri, ali je datum poznejši. LocalDate.equals primerja vrednosti datumov tipa LocalDate, ne identitete objektov — ne zamenjajte ga z ==. Za dva objekta LocalDate metoda LocalDate.compareTo glede na vrstni red datumov vrne negativno število, nič ali pozitivno število; ne predpostavljajte, da je rezultat natančno -1 ali 1.

LocalDate.parse(text) prebere datum ISO; različica s formatterjem podpira drugo obliko. Napaka pri razčlenjevanju povzroči DateTimeParseException. LocalDate.toString vrne besedilo ISO, LocalDate.format(formatter) pa uporabi podani formatter. V vzorcu dd/MM/uuuu uuuu pomeni leto, ne leto dobe (yyyy).

LocalDate.atTime(hour, minute) ustvari LocalDateTime, še vedno brez časovnega pasu; različica z OffsetTime vrne OffsetDateTime. Primer uporablja fiksne datume in prikazuje 29. februar 2024. Obseg dokumentacije: Java SE 21; produkcijsko okolje ni potrjeno.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri