CKTIS / Java
LocalDate: ustvarjanje, premikanje, primerjanje in prikaz datumov
Ustvari datum po koledarju ISO, premakni ga za koledarske dni brez spreminjanja izvirnika, primerjaj ga z drugim datumom in ga pretvori v besedilo.
Različica: 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 po koledarju ISO brez ure in časovnega pasu. Statična tovarniška metoda LocalDate.of sprejme leto, mesec in dan v mesecu v tem vrstnem redu. Mesec podaj kot int od 1 do 12 ali kot vrednost tipa Month, ki ni null, na primer Month.FEBRUARY. Neveljavnega datuma, kot je 29. februar v neprestopnem letu, metoda ne popravi, ampak sproži izjemo DateTimeException.
date.plusDays(n) sprejme število koledarskih dni tipa long in vrne izračunani datum, po potrebi v drugem mesecu ali letu. Negativna vrednost premakne datum nazaj, ničla pa ohrani njegovo vrednost. LocalDate je nespremenljiv: klic ne spremeni date, zato vrnjeno vrednost shrani ali uporabi. Če pri izračunu ne pride do prekoračitve, vendar je rezultat zunaj podprtega razpona datumov, metoda sproži izjemo DateTimeException, na primer pri LocalDate.MAX.plusDays(1). Če v JDK 21 vmesna vsota števila dni od epohe in prištetih dni preseže meje tipa long, metoda sproži izjemo ArithmeticException, še preden preveri razpon datumov.
a.isAfter(b) vrne true samo, če je a poznejši od b. Če je a zgodnejši ali oba predstavljata isti dan, vrne false. Parameter je tipa ChronoLocalDate in b ne sme biti null. Primerjava upošteva položaj datumov na lokalni časovni osi ne glede na njun koledarski sistem.
date.toString() vrne String v obliki ISO-8601 uuuu-MM-dd, na primer 2024-03-01. Metoda ničesar ne izpiše in besedila ne prilagaja področnim nastavitvam. Za zapis, prilagojen bralcu, uporabi format z ustreznim DateTimeFormatter.
Primeri
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
Leto 2024 je prestopno, zato je dva dni po `2024-02-28` datum `2024-03-01`. Prva vrstica pokaže nespremenjeni začetni datum; zadnji dve pokažeta, da je rezultat poznejši od začetnega datuma, ne pa od samega sebe.
Povezane lekcije
- Java · Lekcija 68 · Osnovna · Različica: 2