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

CKTIS / Java

ZoneId.of y ZoneId.getRules: reglas de zona horaria

Consulta los desfases respecto a UTC en Varsovia y Nueva York en el mismo instante de 2025 y comprueba por qué un desfase fijo no sustituye a una zona regional.

Versión: Java SE 21

Sintaxis

java.time.ZoneId
  public static ZoneId of(String zoneId)
  public static ZoneId of(String zoneId, java.util.Map<String, String> aliasMap)
  public abstract java.time.zone.ZoneRules getRules()

El método de factoría estático ZoneId.of(String), de java.time, valida un identificador y devuelve un ZoneId. Europe/Warsaw y America/New_York identifican zonas regionales; +01:00 da un ZoneOffset, un desfase fijo respecto a UTC. Que dos zonas coincidan en un instante no significa que sigan las mismas reglas.

La sobrecarga ZoneId.of(String, Map<String, String>) permite definir tu propio mapa de alias a identificadores. Prefiere los identificadores regionales a las abreviaturas ambiguas. Un formato incorrecto provoca una DateTimeException; un identificador regional bien formado pero desconocido provoca una ZoneRulesException, subtipo de DateTimeException.

El método de instancia ZoneId.getRules() devuelve un objeto inmutable java.time.zone.ZoneRules. getOffset(Instant) da el único desfase vigente en ese instante. Para un LocalDateTime, usa getValidOffsets: devuelve cero desfases en el intervalo omitido al adelantar el reloj, uno fuera de una transición y normalmente dos en el intervalo repetido al atrasarlo. En teoría, puede haber más de dos desfases válidos si se atrasa el reloj dos veces en rápida sucesión. En un intervalo omitido o repetido, getOffset(LocalDateTime) devuelve el desfase anterior a la transición; en el intervalo omitido no es válido para la hora local indicada.

Las reglas regionales proceden de un ZoneRulesProvider; la fuente de datos predeterminada es la TZDB de IANA. Los resultados históricos dependen de los datos del entorno de ejecución. Un proveedor con actualizaciones dinámicas puede devolver otras reglas en una llamada posterior a getRules(). Si no están disponibles las reglas de un identificador deserializado, getRules() lanza una ZoneRulesException.

Ejemplos

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

public class Main {
    public static void main(String[] args) {
        ZoneRules warsaw = ZoneId.of("Europe/Warsaw").getRules();
        ZoneRules newYork = ZoneId.of("America/New_York").getRules();
        ZoneRules fixed = ZoneId.of("+01:00").getRules();

        System.out.println("UTC instant | Europe/Warsaw | America/New_York | fixed +01:00");
        for (String timestamp : new String[] {
                "2025-03-01T12:00:00Z", "2025-03-15T12:00:00Z", "2025-04-01T12:00:00Z"
        }) {
            Instant instant = Instant.parse(timestamp);
            System.out.println(instant + " | " + warsaw.getOffset(instant)
                    + " | " + newYork.getOffset(instant) + " | " + fixed.getOffset(instant));
        }
    }
}

Resultado

UTC instant | Europe/Warsaw | America/New_York | fixed +01:00
2025-03-01T12:00:00Z | +01:00 | -05:00 | +01:00
2025-03-15T12:00:00Z | +01:00 | -04:00 | +01:00
2025-04-01T12:00:00Z | +02:00 | -04:00 | +01:00

Cada fila compara el mismo instante UTC. El 15 de marzo de 2025 Nueva York ya está en horario de verano, pero Varsovia aún no. Para el 1 de abril, Varsovia también ha cambiado de desfase; el desfase fijo `+01:00` no cambia.

Lecciones relacionadas

  • Java · Lección 60 · Avanzado · Versión: 2

Fuentes