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

CKTIS / Java

Tempo e fusos em Java

Tempo e fusos em Java: A API java.time separa o Instant na linha temporal, a Duration, a data LocalDate e o ZonedDateTime regido pelas regras de ZoneId.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

time

A API java.time separa o Instant na linha temporal, a Duration, a data LocalDate e o ZonedDateTime regido pelas regras de ZoneId.

Injeta Clock no código que lê a hora atual, guarda eventos como Instant e converte-os para um fuso apenas na fronteira de apresentação.

LocalDateTime não contém fuso nem instante único; Period conta unidades de calendário e Duration segundos e nanossegundos, portanto não são permutáveis.

Uma transição DST pode omitir ou repetir horas locais, as regras de fuso podem mudar e adicionar um dia civil nem sempre significa 24 horas.

A passagem DST muda 01:30+01:00 para 04:30+02:00 com elapsed=2; Clock.fixed dá date=2024-03-31.

Exemplos

import java.time.*;
public class Main {
  public static void main(String[] args) {
    var instant=Instant.parse("2024-03-31T00:30:00Z");
    var zone=ZoneId.of("Europe/Warsaw");
    var start=instant.atZone(zone); var end=start.plusHours(2);
    System.out.println(start); System.out.println(end);
    System.out.println("elapsed="+Duration.between(start.toInstant(),end.toInstant()).toHours());
    System.out.println("date="+LocalDate.now(Clock.fixed(instant,zone)));
  }
}

Resultado

2024-03-31T01:30+01:00[Europe/Warsaw]
2024-03-31T04:30+02:00[Europe/Warsaw]
elapsed=2
date=2024-03-31

A passagem DST muda 01:30+01:00 para 04:30+02:00 com elapsed=2; Clock.fixed dá date=2024-03-31.

Fontes