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 no 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 horário 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 tempo entre fusos horários:

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 o DateTimeFormatter. Você pode incluir o deslocamento do fuso horário (offset) na saída usando a letra de padrão Z ou XXX:

// 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 recebe quatro argumentos:

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

O método deve:

Analisar a data e hora de entrada no fuso horário de origem
Convertê-la para o fuso horário de destino
Retornar informações formatadas sobre ambos os horários

As mensagens de retorno devem ser:

Se a data/hora for inválida: retornar "Invalid datetime format"
Se o fuso horário for inválido: retornar "Invalid time zone"
Se showOffset for true: incluir o deslocamento na saída
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));
    }
}