Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

ZoneId.of: seleccionar una zona horaria por su identificador

Usa `ZoneId.of` para elegir una zona horaria regional o un desfase fijo respecto a UTC y mostrar el mismo instante en Varsovia, Nueva York y Tokio.

Versión: Java SE 21

Sintaxis

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) es un método de fábrica estático de la clase java.time.ZoneId. Recibe un identificador no null y devuelve una zona cuyas reglas están disponibles en el entorno de ejecución. Por sí solo no crea una fecha ni una hora.

Europe/Warsaw, America/New_York y Asia/Tokyo son identificadores regionales de la base IANA TZDB que se usa de forma predeterminada. Respeta las mayúsculas y minúsculas. El desfase de una zona regional depende de sus reglas y del instante, por lo que puede cambiar, por ejemplo al entrar en el horario de verano. +02:00 y Z devuelven un ZoneOffset fijo. UTC, GMT y UT conservan sus identificadores con un desfase cero; UTC+02:00 conserva el prefijo UTC y tiene un desfase fijo.

ZoneId.of(String, Map<String, String>) primero sustituye el identificador por el valor asociado si el mapa contiene la clave correspondiente; después resuelve el identificador resultante igual que la sobrecarga de un argumento. El mapa no puede ser null. Puedes pasar explícitamente ZoneId.SHORT_IDS para abreviaturas heredadas. No des por hecho que las abreviaturas son inequívocas ni que la sobrecarga de un argumento usa este mapa.

Una sintaxis no válida provoca DateTimeException; un identificador regional bien formado pero no disponible provoca ZoneRulesException, una subclase de DateTimeException. Gestiona estos errores de forma explícita en lugar de recurrir silenciosamente a la zona predeterminada. En el ejemplo, Instant.atZone crea un ZonedDateTime: cambia la representación local, pero no el instante. Los identificadores regionales y sus reglas disponibles dependen de los datos de zonas horarias del entorno de ejecución.

Ejemplos

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

Resultado

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]

Cada línea representa el mismo instante fijo como fecha y hora locales, seguidas del desfase respecto a UTC y del identificador regional entre corchetes.

Lecciones relacionadas

  • Java · Lección 59 · Intermedio · Versión: 2

Fuentes