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

CKTIS / Java

ZoneId.of: izbira časovnega pasu po identifikatorju

Z `ZoneId.of` izberete regionalni časovni pas ali stalni odmik od UTC in prikažete isti trenutek v Varšavi, New Yorku in Tokiu.

Različica: Java SE 21

Sintaksa

import java.time.ZoneId;
import java.util.Map;

// Static method signatures in java.time.ZoneId:
public static ZoneId of(String zoneId)
public static ZoneId of(String zoneId, Map<String, String> aliasMap)

// Example calls:
ZoneId.of("Europe/Warsaw")
ZoneId.of("+02:00")
ZoneId.of("office", Map.of("office", "Europe/Warsaw"))

ZoneId.of(String) je statična tovarniška metoda razreda java.time.ZoneId. Sprejme identifikator, ki ni null, in vrne časovni pas, katerega pravila so na voljo v izvajalnem okolju. Sama ne ustvari datuma ali časa.

Europe/Warsaw, America/New_York in Asia/Tokyo so regionalni identifikatorji iz privzete zbirke IANA TZDB. Ohranite velike in male črke. Odmik regionalnega pasu je odvisen od njegovih pravil in izbranega trenutka, zato se lahko spremeni, na primer ob prehodu na poletni čas. +02:00 in Z vrneta stalni ZoneOffset. UTC, GMT in UT obdržijo svoj identifikator in imajo ničelni odmik; UTC+02:00 obdrži predpono UTC in ima stalni odmik.

ZoneId.of(String, Map<String, String>) najprej zamenja identifikator s pripadajočo vrednostjo, če preslikava vsebuje ustrezen ključ. Nato dobljeni identifikator razreši enako kot preobremenjena metoda z enim argumentom. Preslikava ne sme biti null. Za starejše okrajšave lahko izrecno podate ZoneId.SHORT_IDS. Ne predpostavljajte, da so okrajšave enoumne ali da različica z enim argumentom uporablja to preslikavo.

Neveljaven zapis povzroči izjemo DateTimeException; pravilno zapisan, a nedostopen regionalni identifikator povzroči ZoneRulesException, podrazred DateTimeException. Te napake obravnavajte izrecno, namesto da bi tiho uporabili privzeti pas. V primeru Instant.atZone ustvari ZonedDateTime: lokalni prikaz se spremeni, trenutek pa ostane isti. Razpoložljivi regionalni identifikatorji in pravila so odvisni od podatkov o časovnih pasovih v izvajalnem okolju.

Primeri

import java.time.Instant;
import java.time.ZoneId;

public class ZoneIdExample {
    public static void main(String[] args) {
        Instant instant = Instant.parse("2024-07-01T12:00:00Z");
        String[] zoneIds = {"Europe/Warsaw", "America/New_York", "Asia/Tokyo"};

        for (String id : zoneIds) {
            ZoneId zone = ZoneId.of(id);
            System.out.println(instant.atZone(zone));
        }
    }
}

Rezultat

2024-07-01T14:00+02:00[Europe/Warsaw]
2024-07-01T08:00-04:00[America/New_York]
2024-07-01T21:00+09:00[Asia/Tokyo]

Vsaka vrstica prikaže isti vnaprej določen trenutek kot lokalni datum in čas, ki jima sledita odmik od UTC in regionalni identifikator v oglatih oklepajih.

Povezane lekcije

  • Java · Lekcija 59 · Srednja · Različica: 2

Viri