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.