Tratamento de Fuso Horário

Parte da seção Lógica e Fluxo do Journey de Java da Coddy. Lição 59 de 59.

ZonedDateTime em Java representa uma data e hora com um fuso horário. É útil ao trabalhar com diferentes fusos horários ou ao converter entre eles.

Crie um horário em um fuso específico:

ZonedDateTime tokyo = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));

Você também pode criar um ZonedDateTime a partir de um LocalDateTime usando .atZone():

LocalDateTime localDT = LocalDateTime.of(2024, 3, 15, 10, 30);
ZonedDateTime tokyo = localDT.atZone(ZoneId.of("Asia/Tokyo"));

Converta o horário entre fusos:

ZonedDateTime newYork = tokyo.withZoneSameInstant(ZoneId.of("America/New_York"));

Após executar o código acima, newYork contém o mesmo instante que tokyo, mas no fuso horário de Nova York:

2024-03-15T10:30-04:00[America/New_York]
// Exemplo de saída

Para formatar um ZonedDateTime, use DateTimeFormatter. Adicione o deslocamento com o padrão xxx: ele exibe +09:00 ou -04:00, e um deslocamento zero como +00:00 (o XXX em maiúsculas exibe Z para um deslocamento zero):

// Sem offset
DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
// Com offset (ex. +09:00 ou -04:00)
DateTimeFormatter fmtWithOffset = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm xxx");
String result = newYork.format(fmtWithOffset);
// Exemplo: 2024-03-15 10:30 -04:00

Desafio

Fácil

Crie um método chamado convertTime que receba quatro argumentos:

Uma String (dateTimeStr) no formato "yyyy-MM-dd HH:mm"
Uma String (sourceZone) o ID do fuso horário de origem
Uma String (targetZone) o ID do fuso horário de destino
Um booleano (showOffset) que indica se o deslocamento do fuso horário deve ser incluído na saída

O método deve:

Analisar o datetime de entrada no fuso horário de origem
Convertê-lo para o fuso horário de destino
Retornar informações formatadas sobre ambos os horários

As mensagens retornadas devem ser:

Se o datetime for inválido: retornar "Invalid datetime format"
Se o fuso for inválido: retornar "Invalid time zone"
Se showOffset for true: incluir o deslocamento na saída, formatado com o padrão xxx, de modo que um deslocamento zero seja exibido como +00:00
Formato: "Source: [time1], Target: [time2]"

Experimente você mesmo

import java.util.Scanner;
import java.time.*;
import java.time.format.*;

public class Main {
    public static String convertTime(String dateTimeStr, String sourceZone, 
                                   String targetZone, boolean showOffset) {
        // Escreva seu código aqui
    }
    
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        String dateTimeStr = scanner.nextLine();
        String sourceZone = scanner.nextLine();
        String targetZone = scanner.nextLine();
        boolean showOffset = Boolean.parseBoolean(scanner.nextLine());
        
        System.out.println(convertTime(dateTimeStr, sourceZone, targetZone, showOffset));
    }
}