Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

ZoneRules — offsets válidos e mudanças do relógio

ZoneRules descreve as alterações do offset de uma zona. Os métodos getValidOffsets e getTransition detetam horas locais inexistentes ou ambíguas antes de ser escolhido um offset.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

ZoneRules descreve as regras de offset de uma zona. ZoneRules.getValidOffsets(LocalDateTime) devolve uma lista vazia para uma lacuna, normalmente um elemento ou dois no caso de uma sobreposição. Numa sobreposição, o offset anterior à transição aparece primeiro; teoricamente, podem existir mais de dois offsets.

ZoneRules.getTransition(LocalDateTime) devolve uma ZoneOffsetTransition para uma lacuna ou sobreposição e, nos restantes casos, null. Adiantar os relógios cria horas locais inexistentes; atrasá-los cria horas que ocorrem duas vezes. isGap() e isOverlap() distinguem estes casos. Não assuma que uma transição dura uma hora.

Defina uma política explícita: rejeite uma lacuna ou ajuste a hora; numa sobreposição, escolha deliberadamente um offset. getOffset(LocalDateTime) por si só não valida a hora: nas lacunas e sobreposições, devolve o offset anterior à transição.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes