Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

ZonedDateTime: stejný okamžik, nebo stejný místní čas?

V Javě 21 vytvořte datum a čas s časovým pásmem, výslovně zvolte každý ze dvou výskytů opakovaného času a při změně pásma rozlišujte okamžik od údaje na hodinách.

Verze: Java SE 21

Syntaxe

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 spojuje místní datum a čas s identifikátorem časového pásma (ZoneId) a posunem vůči UTC (ZoneOffset). Instant je bod na časové ose. Místní datum a čas jsou údaje z kalendáře a hodin; v daném pásmu mohou označovat dva různé okamžiky.

ZonedDateTime.of je statická tovární metoda se třemi přetíženími: přijímá LocalDateTime, dvojici LocalDate a LocalTime nebo sedm číselných polí, vždy spolu s ZoneId. Pokud existuje jediný platný posun, použije jej. Při překryvu, kdy se místní interval opakuje, zvolí posun prvního výskytu. V mezeře, kdy se místní interval přeskočí, posune místní datum a čas dopředu o délku mezery a použije posun po přechodu. Neplatná pole data nebo času v číselném přetížení vyvolají DateTimeException.

ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) je statická tovární metoda. Při překryvu použije preferovaný posun, jen pokud jde o jeden ze dvou platných posunů; při null nebo neodpovídajícím posunu vybere první výskyt. Při jediném platném posunu nebo v mezeře se chová jako of. Preference není validace: pokud má aplikace odmítat mezery nebo u překryvu vyžadovat výslovnou volbu, zkontrolujte zone.getRules().getValidOffsets(localDateTime), které vrací 0, 1 nebo 2 posuny.

ZonedDateTime.withZoneSameInstant(zone) zobrazí tutéž událost v jiném pásmu: toInstant() vrátí stejnou hodnotu, i když se místní datum nebo čas změní. Nemusí řešit místní mezery ani překryvy; výsledek mimo podporovaný rozsah dat vyvolá DateTimeException. ZonedDateTime.withZoneSameLocal(zone) interpretuje stejné datum a čas jako místní údaje cílového pásma, takže okamžik se může změnit. Řídí se pravidly ofLocal a preferuje dosavadní posun. V mezeře původní místní datum a čas zachovat nedokáže. Ani jedna metoda nemění původní objekt.

Pří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ýsledek

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

Podle pravidel pro `Europe/Paris` použitých v příkladu nastává `02:30` dvakrát: `+02:00` odpovídá `00:30Z` a `+01:00` odpovídá `01:30Z`. `of` vybere první výskyt; dvě volání `ofLocal` výslovně vyberou oba posuny. Při převodu prvního výskytu na UTC dostanete `00:30Z`, pokud zachováte okamžik, nebo `02:30Z`, pokud zachováte údaj na hodinách. Výsledky pro regionální pásmo závisí na pravidlech dostupných v běhovém prostředí.

Související lekce

  • Java · Lekce 60 · Pokročilá · Verze: 2

Zdroje