CKTIS / Java
ZonedDateTime: isti trenutak ili isto lokalno vrijeme?
U Javi 21 stvori datum i vrijeme s vremenskom zonom, izričito odaberi svako od dvaju pojavljivanja ponovljenog vremena i pri promjeni zone sačuvaj trenutak ili očitanje sata.
Verzija: Java SE 21
Sintaksa
java.time.ZonedDateTime — Java SE 21
public static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)
public static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
public static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
public static ZonedDateTime ofLocal(LocalDateTime localDateTime, ZoneId zone, ZoneOffset preferredOffset)
public ZonedDateTime withZoneSameInstant(ZoneId zone)
public ZonedDateTime withZoneSameLocal(ZoneId zone)java.time.ZonedDateTime povezuje lokalni datum i vrijeme s identifikatorom vremenske zone (ZoneId) i pomakom u odnosu na UTC (ZoneOffset). Instant je točka na vremenskoj crti. Lokalni datum i vrijeme ono su što pokazuju kalendar i sat; u određenoj zoni mogu označavati dva različita trenutka.
ZonedDateTime.of statička je tvornička metoda s trima preopterećenjima: prima LocalDateTime, par LocalDate i LocalTime ili sedam brojčanih polja, uvijek zajedno sa ZoneId. Ako postoji samo jedan valjani pomak, koristi njega. Pri preklapanju, kada se lokalni interval ponavlja, bira pomak prvog pojavljivanja. U praznini, kada se lokalni interval preskače, pomiče lokalni datum i vrijeme unaprijed za trajanje praznine i koristi pomak nakon prijelaza. Nevaljana polja datuma ili vremena u brojčanom preopterećenju uzrokuju DateTimeException.
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) statička je tvornička metoda. Pri preklapanju koristi željeni pomak samo ako je jedan od dvaju valjanih. Za null ili pomak koji ne odgovara bira prvo pojavljivanje. Ako postoji samo jedan valjani pomak ili je vrijeme u praznini, ponaša se kao of. Željeni pomak ne služi za provjeru valjanosti: ako aplikacija mora odbiti praznine ili zahtijevati izričit odabir pri preklapanju, provjeri zone.getRules().getValidOffsets(localDateTime), koji vraća 0, 1 ili 2 pomaka.
ZonedDateTime.withZoneSameInstant(zone) prikazuje isti događaj u drugoj zoni: toInstant() daje jednaku vrijednost čak i ako se lokalni datum ili vrijeme promijeni. Nema potrebe razrješavati lokalne praznine ili preklapanja; rezultat izvan podržanog raspona datuma uzrokuje DateTimeException. ZonedDateTime.withZoneSameLocal(zone) isti datum i vrijeme tumači kao lokalne podatke ciljne zone pa se trenutak može promijeniti. Slijedi pravila metode ofLocal i koristi trenutačni pomak kao željeni. U praznini ne može zadržati izvorni lokalni datum i vrijeme. Nijedna metoda ne mijenja izvorni objekt.
Primjeri
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
public class ZonedDateTimeTransform {
public static void main(String[] args) {
ZoneId paris = ZoneId.of("Europe/Paris");
LocalDateTime wallTime = LocalDateTime.of(2024, 10, 27, 2, 30);
ZonedDateTime defaultChoice = ZonedDateTime.of(wallTime, paris);
ZonedDateTime earlier = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(2));
ZonedDateTime later = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(1));
System.out.println("of: " + defaultChoice);
System.out.println("ofLocal +02:00: " + earlier + " -> " + earlier.toInstant());
System.out.println("ofLocal +01:00: " + later + " -> " + later.toInstant());
System.out.println("same instant: " + earlier.withZoneSameInstant(ZoneOffset.UTC));
System.out.println("same local: " + earlier.withZoneSameLocal(ZoneOffset.UTC));
}
}Rezultat
of: 2024-10-27T02:30+02:00[Europe/Paris] ofLocal +02:00: 2024-10-27T02:30+02:00[Europe/Paris] -> 2024-10-27T00:30:00Z ofLocal +01:00: 2024-10-27T02:30+01:00[Europe/Paris] -> 2024-10-27T01:30:00Z same instant: 2024-10-27T00:30Z same local: 2024-10-27T02:30Z
Prema pravilima za `Europe/Paris` iz primjera `02:30` pojavljuje se dvaput: `+02:00` daje `00:30Z`, a `+01:00` daje `01:30Z`. `of` bira prvo pojavljivanje; dva poziva metode `ofLocal` izričito biraju oba pomaka. Pretvaranjem prvog pojavljivanja u UTC dobivaš `00:30Z` ako zadržavaš trenutak ili `02:30Z` ako zadržavaš očitanje sata. Rezultati za regionalnu zonu ovise o pravilima dostupnima u okruženju za izvršavanje.
Povezane lekcije
- Java · Lekcija 60 · Napredno · Verzija: 2