CKTIS / Java
ZoneOffset — un desplazamiento fijo respecto de UTC
ZoneOffset describe un desplazamiento fijo respecto de UTC, no las reglas de una zona horaria regional. ZoneOffset.UTC representa el desplazamiento cero, cuyo identificador es Z.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
ZoneOffset.UTC
ZoneOffset.of("+02:00")
ZoneOffset.ofHoursMinutes(-5, -30)
offset.getId()
offset.getTotalSeconds()java.time.ZoneOffset representa una diferencia fija respecto de UTC, por ejemplo, +02:00. No almacena ni una fecha ni una hora. Un ZoneId regional, como Europe/Paris, define reglas para determinar el desplazamiento en un instante; un desplazamiento por sí solo no describe los cambios del horario de verano.
ZoneOffset.UTC representa el desplazamiento cero; getId() devuelve Z para este valor. Fábricas como of("+02:00") y ofHoursMinutes(-5, -30) crean otros valores. Los componentes distintos de cero deben tener el mismo signo. El rango va de -18:00 a +18:00, ambos incluidos; un valor no válido provoca una DateTimeException.
Las instancias son inmutables y seguras para los hilos. Compáralas con equals, no con ==, y no las uses como bloqueos de sincronización. El ejemplo muestra identificadores normalizados, un desplazamiento en segundos y la igualdad entre dos representaciones del desplazamiento cero.
Ejemplos
import java.time.ZoneOffset;
public class Main {
public static void main(String[] args) {
ZoneOffset offset = ZoneOffset.ofHoursMinutes(-5, -30);
System.out.println(ZoneOffset.UTC.getId());
System.out.println(offset.getId());
System.out.println(offset.getTotalSeconds());
System.out.println(ZoneOffset.UTC.equals(ZoneOffset.of("+00:00")));
}
}Resultado
Z -05:30 -19800 true
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.