Eu recebo variáveis de timezone em formato de região, ex: America/Sao_Paulo
.
Tem como transformá-la na diferença de horário em relação a UTC? No caso seria -3
ou -03:00
.
Stack Overflow em Português é um site de perguntas e respostas para programadores profissionais e entusiastas. Leva apenas um minuto para se inscrever.
Inscreva-se para participar desta comunidadeEu recebo variáveis de timezone em formato de região, ex: America/Sao_Paulo
.
Tem como transformá-la na diferença de horário em relação a UTC? No caso seria -3
ou -03:00
.
Antes de dar a solução, tem um detalhe importante a se considerar:
-3
Timezones como America/Sao_Paulo
são definidos pela IANA, e segundo a documentação deles, um timezone representa o histórico de offsets que determinada região teve ao longo do tempo. Ou seja, não necessariamente será apenas um único valor.
No caso de America/Sao_Paulo
, existem vários períodos em que teve horário de verão, no qual o offset muda para -2
.
Atualmente (janeiro de 2023) não tem horário de verão, mas lembre-se que isso é definido pelo governo, e historicamente é algo que vive mudando (não só no Brasil, mas no mundo todo). Pode ser que volte, pode ser que resolvam mudar para outro porque sim, a única certeza que temos é que não dá pra ter certeza de que sempre será assim. Só porque hoje é -3
, nada garante que continuará assim pra sempre.
Ou seja, além do identificador do timezone, você sempre precisa de uma data de referência. Em determinada data, o offset de um timezone tem um valor. Em outra data, pode ou não ter o mesmo valor.
Claro que no caso de America/Sao_Paulo
, para a maioria dos casos vai ser -3
, mas ainda sim, não dá pra assumir que sempre é. Você precisa informar uma data, porque pode ser que esteja em horário de verão. E dependendo do timezone, pode ser um offset completamente diferente (existem países que simplesmente decidem mudar seu offset "em definitivo" - exemplos: 1, 2).
Enfim, sabendo disso, uma solução é primeiro criar um DateTimeZone
e em seguida usar o método getOffset
passando a data como argumento. O detalhe é que este método retorna o offset em segundos, então para saber a quantidade de horas precisa dividir por 3600:
$tz = new DateTimeZone('America/Sao_Paulo');
// data atual - provavelmente -3, ***a não ser que o horário de verão volte***
// aí pode ser -3 ou -2 dependendo da data
echo $tz->getOffset(new DateTime()) / 3600; // -3
// uma data que com certeza está no horário de verão
echo $tz->getOffset(new DateTime('2000-01-10T10:00Z')) / 3600; // -2
Também dá para criar a data e obter o offset diretamente dela:
$tz = new DateTimeZone('America/Sao_Paulo');
// data atual
$d = new DateTime('now', $tz);
echo $d->getOffset() / 3600; // -3 (ou -2 se a data atual estiver em horário de verão)
// data em horário de verão
$d = new DateTime('2000-01-10T10:00', $tz);
echo $d->getOffset() / 3600; // -2
Mas se quiser no formato -03:00
, aí precisa formatar a data:
$tz = new DateTimeZone('America/Sao_Paulo');
// data atual
$d = new DateTime('now', $tz);
echo $d->format('P'); // -03:00 (ou -02:00 se a data atual estiver em horário de verão)
// data em horário de verão
$d = new DateTime('2000-01-10T10:00', $tz);
echo $d->format('P'); // -02:00
Vale lembrar também que nem todo offset é de "hora cheia". Por exemplo, na Índia, atualmente o offset é +05:30
(5 horas e meia à frente do UTC). Ou seja, a primeira solução (dividir por 3600) vai dar um valor quebrado (e neste caso, acho que seria mais claro usar o valor formatado):
$tz = new DateTimeZone('Asia/Kolkata');
$d = new DateTime('2000-01-10T10:00', $tz);
echo $d->getOffset() / 3600; // 5.5
echo $d->format('P'); // +05:30
Lembrando que, como essas informações de timezone mudam o tempo todo, o banco de dados da IANA está em constante mudança, e novas versões são anunciadas aqui.
No caso do PHP, você pode atualizar a extensão timezonedb
, já que esta é sincronizada com as atualizações da IANA.