Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

ZonedDateTime: rovnaký okamih alebo rovnaký miestny čas?

V Jave 21 vytvorte dátum a čas s časovým pásmom, výslovne vyberte každý z dvoch výskytov opakovaného času a pri zmene pásma odlíšte okamih od údaja na hodinách.

Verzia: Java SE 21

Syntax

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 spája miestny dátum a čas s identifikátorom časového pásma (ZoneId) a posunom voči UTC (ZoneOffset). Instant je bod na časovej osi. Miestny dátum a čas sú údaje z kalendára a hodín; v danom pásme môžu označovať dva rôzne okamihy.

ZonedDateTime.of je statická továrenská metóda s tromi preťaženiami: prijíma LocalDateTime, dvojicu LocalDate a LocalTime alebo sedem číselných polí, vždy spolu s ZoneId. Ak existuje jediný platný posun, použije ho. Pri prekrytí, keď sa miestny interval opakuje, vyberie posun prvého výskytu. V medzere, keď sa miestny interval preskočí, posunie miestny dátum a čas dopredu o dĺžku medzery a použije posun po prechode. Neplatné polia dátumu alebo času v číselnom preťažení vyvolajú DateTimeException.

ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) je statická továrenská metóda. Pri prekrytí použije uprednostnený posun len vtedy, ak je jedným z dvoch platných. Pri null alebo nevyhovujúcom posune vyberie prvý výskyt. Pri jedinom platnom posune alebo v medzere sa správa ako of. Preferencia nie je validácia: ak má aplikácia odmietať medzery alebo pri prekrytí vyžadovať výslovný výber, skontrolujte zone.getRules().getValidOffsets(localDateTime), ktoré vracia 0, 1 alebo 2 posuny.

ZonedDateTime.withZoneSameInstant(zone) zobrazí tú istú udalosť v inom pásme: toInstant() vráti rovnakú hodnotu, aj keď sa miestny dátum alebo čas zmení. Miestne medzery ani prekrytia netreba riešiť; výsledok mimo podporovaného rozsahu dátumov vyvolá DateTimeException. ZonedDateTime.withZoneSameLocal(zone) interpretuje rovnaký dátum a čas ako miestne údaje cieľového pásma, takže okamih sa môže zmeniť. Riadi sa pravidlami ofLocal a uprednostňuje doterajší posun. V medzere nedokáže zachovať pôvodný miestny dátum a čas. Ani jedna metóda nemení pôvodný objekt.

Príklady

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));
    }
}

Výsledok

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

Podľa pravidiel pre `Europe/Paris` použitých v príklade nastane `02:30` dvakrát: `+02:00` zodpovedá `00:30Z` a `+01:00` zodpovedá `01:30Z`. `of` vyberie prvý výskyt; dve volania `ofLocal` výslovne vyberú oba posuny. Pri prevode prvého výskytu na UTC dostanete `00:30Z`, ak zachováte okamih, alebo `02:30Z`, ak zachováte údaj na hodinách. Výsledky pre regionálne pásmo závisia od pravidiel dostupných v prostredí vykonávania.

Súvisiace lekcie

  • Java · Lekcia 60 · Pokročilá · Verzia: 2

Zdroje