Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

ZoneId — identifikator časovnega pasu

ZoneId določa časovni pas, ZoneRules pa opisuje njegova pravila odmika od UTC. Spoznajte ZoneId.of, ZoneId.getRules in razliko med regijo ter fiksnim odmikom.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();

java.time.ZoneId določa časovni pas; datuma ali časa ne shranjuje. ZoneId.of(String) ustvari identifikator regije, na primer Europe/Paris, ali identifikator fiksnega odmika, na primer +02:00. Regija ni isto kot fiksni odmik.

ZoneId.getRules() vrne ZoneRules. Njegova metoda getOffset(Instant) poda odmik za določen trenutek, medtem ko isFixedOffset() preveri, ali se ta odmik nikoli ne spremeni. Pravila regij lahko vključujejo spremembe ure in so odvisna od podatkov, ki so na voljo v izvajalnem okolju.

Za Instant velja en sam ustrezen odmik. Pri pretvorbi LocalDateTime pa lahko prehod med odmiki povzroči vrzel ali prekrivanje lokalnih časov. getValidOffsets(LocalDateTime) pomaga prepoznati te primere; ne predpostavljajte, da lokalni čas vedno določa en sam trenutek.

Neveljavna oblika, podana metodi ZoneId.of, povzroči DateTimeException, neznana regija pa ZoneRulesException. Tudi ZoneId.getRules lahko sproži ZoneRulesException, če pravila niso na voljo. Primer uporablja fiksni odmik in določen trenutek, zato izpis ni odvisen od ure ali posodobitev podatkov regij.

Primeri

import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;

public class Main {
    public static void main(String[] args) {
        ZoneId zone = ZoneId.of("+02:00");
        ZoneRules rules = zone.getRules();
        Instant instant = Instant.parse("2024-01-15T12:00:00Z");

        System.out.println(zone.getId());
        System.out.println(rules.isFixedOffset());
        System.out.println(rules.getOffset(instant));
    }
}

Rezultat

+02:00
true
+02:00

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri