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

CKTIS / Java

ZoneRules — offsets válidos y cambios de hora

ZoneRules describe los cambios en el offset de una zona. Sus métodos getValidOffsets y getTransition permiten detectar horas locales inexistentes o ambiguas antes de elegir un offset.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);

ZoneRules describe las reglas de offset de una zona. ZoneRules.getValidOffsets(LocalDateTime) devuelve una lista vacía si hay un hueco, normalmente un elemento o dos si hay un solapamiento. En un solapamiento, el offset anterior a la transición aparece primero; teóricamente puede haber más de dos offsets.

ZoneRules.getTransition(LocalDateTime) devuelve una ZoneOffsetTransition si hay un hueco o un solapamiento, y null en caso contrario. Adelantar los relojes crea horas locales inexistentes; atrasarlos crea horas que ocurren dos veces. isGap() e isOverlap() distinguen estos casos. No des por sentado que una transición dura una hora.

Define una política explícita: rechaza un hueco o ajusta la hora; si hay un solapamiento, elige el offset deliberadamente. getOffset(LocalDateTime) por sí solo no valida la hora: en los huecos y solapamientos devuelve el offset anterior a la transición.

Ejemplos

import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.zone.ZoneOffsetTransition;
import java.time.zone.ZoneRules;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        ZoneOffset before = ZoneOffset.ofHours(1);
        ZoneOffset after = ZoneOffset.ofHours(2);
        ZoneOffsetTransition jump = ZoneOffsetTransition.of(
                LocalDateTime.of(2024, 3, 31, 2, 0), before, after);
        ZoneRules rules = ZoneRules.of(
                before, before, List.of(), List.of(jump), List.of());

        LocalDateTime local = LocalDateTime.of(2024, 3, 31, 2, 30);
        System.out.println(rules.getValidOffsets(local));
        ZoneOffsetTransition transition = rules.getTransition(local);
        System.out.println(transition != null && transition.isGap());
        System.out.println(rules.getValidOffsets(local.plusHours(1)));
        System.out.println(rules.getTransition(local.plusHours(1)) == null);
    }
}

Resultado

[]
true
[+02:00]
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.

Fuentes