CKTIS / Java
ZoneId — un identificador de zona horaria
ZoneId identifica una zona horaria, mientras que ZoneRules describe sus reglas de desfase respecto a UTC. Aprende ZoneId.of, ZoneId.getRules y la diferencia entre una región y un desfase fijo.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();java.time.ZoneId identifica una zona horaria; no almacena una fecha ni una hora. ZoneId.of(String) crea un identificador de región, como Europe/Paris, o uno de desfase fijo, como +02:00. Una región no es lo mismo que un desfase fijo.
ZoneId.getRules() devuelve ZoneRules. Su método getOffset(Instant) proporciona el desfase para un instante concreto, mientras que isFixedOffset() comprueba si ese desfase nunca cambia. Las reglas regionales pueden incluir cambios de hora y dependen de los datos disponibles en el entorno de ejecución.
A un Instant le corresponde un único desfase aplicable. Sin embargo, al convertir un LocalDateTime, una transición de desfase puede crear un hueco o un solapamiento en las horas locales. getValidOffsets(LocalDateTime) ayuda a detectar estos casos; no des por hecho que una hora local siempre identifica un único instante.
Un formato no válido pasado a ZoneId.of provoca DateTimeException, mientras que una región desconocida provoca ZoneRulesException. ZoneId.getRules también puede lanzar ZoneRulesException si las reglas no están disponibles. El ejemplo usa un desfase fijo y un instante determinado para que el resultado no dependa del reloj ni de las actualizaciones de los datos regionales.
Ejemplos
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));
}
}Resultado
+02:00 true +02:00
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.