Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ZoneId.of: scegliere un fuso orario tramite il suo identificatore

Usa `ZoneId.of` per scegliere un fuso orario regionale o uno scostamento fisso da UTC e mostrare lo stesso istante a Varsavia, New York e Tokyo.

Versione: Java SE 21

Sintassi

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) è un metodo factory statico della classe java.time.ZoneId. Accetta un identificatore non null e restituisce un fuso orario le cui regole sono disponibili nell’ambiente di esecuzione. Da solo non crea una data né un’ora.

Europe/Warsaw, America/New_York e Asia/Tokyo sono identificatori regionali della banca dati IANA TZDB usata per impostazione predefinita. Rispetta le maiuscole e le minuscole. Lo scostamento di un fuso regionale dipende dalle sue regole e dall’istante, quindi può cambiare, per esempio al passaggio all’ora legale. +02:00 e Z restituiscono un ZoneOffset fisso. UTC, GMT e UT mantengono il proprio identificatore con scostamento zero; UTC+02:00 mantiene il prefisso UTC e ha uno scostamento fisso.

ZoneId.of(String, Map<String, String>) sostituisce prima l’identificatore con il valore associato se la mappa contiene la chiave corrispondente, poi risolve l’identificatore risultante come fa la versione con un solo argomento. La mappa non può essere null. Per le vecchie abbreviazioni puoi passare esplicitamente ZoneId.SHORT_IDS. Non dare per scontato che le abbreviazioni siano univoche o che la versione con un argomento usi questa mappa.

Una sintassi non valida causa DateTimeException; un identificatore regionale ben formato ma non disponibile causa ZoneRulesException, una sottoclasse di DateTimeException. Gestisci questi errori esplicitamente invece di ripiegare in silenzio sul fuso predefinito. Nell’esempio Instant.atZone crea un ZonedDateTime: cambia la rappresentazione locale, ma non l’istante. Gli identificatori regionali e le regole disponibili dipendono dai dati sui fusi orari dell’ambiente di esecuzione.

Esempi

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

Risultato

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]

Ogni riga mostra lo stesso istante fissato in anticipo come data e ora locali, seguite dallo scostamento da UTC e dall’identificatore regionale tra parentesi quadre.

Lezioni correlate

  • Java · Lezione 59 · Intermedio · Versione: 2

Fonti