blog
WordPress

Pedido com horário errado: qual das 4 camadas de fuso falhou

Uma página de teste em PHP mostra, lado a lado, a hora do sistema, o fuso do PHP e a versão da base de fusos. Com esse resultado você corrige a camada certa em vez de mexer em tudo.

JR · · 7 min de leitura · 2 tabelas · 2 blocos de código

Resposta curta: na maioria dos casos o erro está em uma de quatro camadas: relógio do sistema, date.timezone da versão de PHP, base de fusos (timezonedb) ou o fuso em Configurações > Geral. Uma página de teste em PHP imprime as quatro lado a lado e mostra qual delas está errada.

Neste artigo
  1. As quatro camadas que decidem a hora gravada
  2. Monte a página de teste em PHP
  3. Como ler o resultado da página de teste
  4. Corrigir a camada do WordPress em Configurações > Geral
  5. Corrigir date.timezone na versão de PHP da conta
  6. Atualizar a base de fusos timezonedb pelo painel
  7. Testar uma camada por vez e apagar a página depois

Relógio do servidor certo, fuso do WordPress certo, e o pedido ainda grava 3 horas a mais. Ou 1 hora a menos, só em parte do ano. Quando isso acontece, não adianta mexer de novo em Configurações > Geral: o horário que vai para o banco passa por camadas diferentes, e basta uma delas usar um fuso diferente para o registro sair torto.

Este guia monta uma página de teste que mostra as camadas lado a lado, ensina a ler o resultado e indica qual ajuste corrige cada caso. É um procedimento documental: a única fonte externa usada é a documentação da LiteSpeed para cPanel sobre a extensão timezonedb (docs.litespeedtech.com). Não há medição de laboratório aqui.

As quatro camadas que decidem a hora gravada

Quando um pedido é criado, o horário final depende de uma cadeia:

Camada Onde fica O que ela define
Relógio do sistema Servidor (NTP) O instante absoluto, normalmente em UTC
date.timezone do PHP Versão de PHP selecionada no painel Fuso que o PHP usa quando o código não informa um
Base de fusos (timezonedb) Extensão da versão de PHP As regras de cada fuso: offset e horário de verão
Fuso do WordPress Configurações > Geral Fuso usado para exibir e converter datas no site

O WordPress guarda a data do post em dois campos: um no fuso local do site e outro em UTC. WooCommerce e plugins de agendamento seguem a mesma lógica, usando as funções de data do WordPress. Por isso o sintoma varia: às vezes a listagem mostra certo e o e-mail sai errado, às vezes o inverso. Cada ponto do código pode estar lendo uma camada diferente.

Vale separar logo dois problemas que costumam ser confundidos:

Uma base desatualizada não transforma São Paulo em UTC. Se o desvio é de 3 horas o ano inteiro, o culpado não é a timezonedb.

As quatro camadas até a hora gravadaRelógio do sistemaInstante absoluto via NTP, em UTCdate.timezone do PHPFuso padrão da versão de PHPBase timezonedbRegras de offset e horário de verãoFuso do WordPressConfigurações > Geral, cidade escolhida
A hora gravada no pedido atravessa as quatro camadas nesta ordem. Basta uma divergir para o registro sair torto.

Monte a página de teste em PHP

Crie um arquivo chamado teste-fuso.php dentro da pasta public_html usando o Gerenciador de Arquivos do cPanel (menu Arquivos > Gerenciador de Arquivos, botão + Arquivo). Cole o conteúdo abaixo:

<?php
header('Content-Type: text/plain; charset=utf-8');

echo "Versao do PHP: " . PHP_VERSION . "\n";
echo "date.timezone (php.ini): " . (ini_get('date.timezone') ?: '(vazio)') . "\n";
echo "Fuso ativo no PHP: " . date_default_timezone_get() . "\n";
echo "Versao da timezonedb: " . timezone_version_get() . "\n";

$agora = new DateTime('now');
echo "Hora no fuso do PHP: " . $agora->format('Y-m-d H:i:s P') . "\n";

$utc = new DateTime('now', new DateTimeZone('UTC'));
echo "Hora em UTC:         " . $utc->format('Y-m-d H:i:s P') . "\n";

$sp = new DateTime('now', new DateTimeZone('America/Sao_Paulo'));
echo "Hora em Sao Paulo:   " . $sp->format('Y-m-d H:i:s P') . "\n";

Linha a linha, o que cada bloco entrega:

Abra https://seudominio.com.br/teste-fuso.php no navegador. O resultado é texto puro.

Como ver o fuso pelo lado do WordPress

A página acima não conhece o WordPress. Para ver o lado do WordPress, use o console de código de um plugin de snippets ou adicione temporariamente ao functions.php do tema filho (com backup antes) uma chamada que imprima:

header('Content-Type: text/plain; charset=utf-8');

echo "timezone_string: " . (get_option('timezone_string') ?: '(vazio)') . "\n";
echo "gmt_offset: " . get_option('gmt_offset') . "\n";
echo "Hora local do site: " . current_time('mysql') . "\n";
echo "Hora em UTC:        " . current_time('mysql', 1) . "\n";

O header força texto puro, então a saída aparece em quatro linhas separadas no navegador, mais ou menos assim: timezone_string: America/Sao_Paulo, gmt_offset: -3, e as duas datas no formato 2024-05-10 14:32:07. Se tudo sair colado em uma linha só, o cabeçalho não foi aplicado (algum plugin já imprimiu conteúdo antes); nesse caso o conteúdo continua legível, só mal formatado.

Se timezone_string vier vazio e gmt_offset vier com um número, o site está configurado por deslocamento fixo (UTC-3) em vez de cidade. Funciona, mas ignora qualquer mudança futura de regra. A recomendação da própria tela de Configurações > Geral é escolher uma cidade.

Como ler o resultado da página de teste

Compare a linha "Hora em UTC" com o horário real de Greenwich no momento do teste. Depois compare as demais.

O que você vê Camada com problema O que fazer
UTC impresso já está errado Relógio do sistema Fale com o suporte do servidor: é NTP, não é site
UTC certo, fuso ativo do PHP é UTC e o site grava 3h a mais date.timezone Ajuste o PHP da conta ou deixe o WordPress resolver
Fuso ativo certo, erro de exatamente 1h em parte do ano Base de fusos (timezonedb) Atualize a extensão no painel
Tudo certo na página, erro só no WordPress Configurações > Geral Troque offset fixo por cidade
Erro só em um plugin Código do plugin Suporte do plugin: ele deve usar wp_timezone()

Na linha "Hora em Sao Paulo", confira o offset no fim: deve aparecer -03:00. Se aparecer -02:00 fora de qualquer contexto esperado, você tem um caso de regra de horário de verão desatualizada e a timezonedb entra na conta.

Que camada corrigir conforme o sintomaUTC impresso já está erradoRelógio do servidor: falar com o suporteUTC certo, fuso do PHP é UTCAjustar date.timezone no MultiPHP INI EditorErro de 1h só em parte do anoAtualizar timezonedb pelo PECLPágina certa, WordPress erradoTrocar offset fixo por cidadeErro só em um pluginSuporte do plugin: usar wp_timezone()
Leia a página de teste de cima para baixo e pare na primeira linha que bater com o seu sintoma.

Corrigir a camada do WordPress em Configurações > Geral

Entre no painel do WordPress, menu Configurações > Geral. No campo Fuso horário, escolha São Paulo na lista de cidades, não UTC-3. Salve e role a página: logo abaixo do campo, o WordPress mostra a hora universal e a hora local, com o próximo ajuste de fuso quando houver.

Se a hora local exibida ali bater com o seu relógio, essa camada está resolvida. Com as camadas de PHP e timezonedb também corretas na página de teste, pedidos criados a partir desse momento gravam certo; se alguma delas ainda estiver torta, repita o teste da seção final antes de dar o caso por encerrado. Pedidos antigos continuam com o valor que foi gravado na hora: o WordPress não recalcula o passado, e reescrever datas no banco é operação de risco que só vale a pena com backup completo e um motivo claro.

Corrigir date.timezone na versão de PHP da conta

No cPanel, abra Software > Selecionar versão do PHP e confirme qual versão está ativa para o domínio. Depois abra o MultiPHP INI Editor, selecione o domínio e procure a diretiva de fuso.

Aqui vale um conselho contra o palpite fácil: o WordPress define o fuso em tempo de execução para as próprias funções de data, então deixar date.timezone como UTC costuma ser inofensivo para um site bem escrito. O problema aparece quando um plugin ou um tema chama date() direto, sem passar pelo WordPress. Nesse caso, alinhar date.timezone com America/Sao_Paulo reduz a chance de divergência entre as duas metades do código.

Depois de salvar, recarregue teste-fuso.php. A linha "Fuso ativo no PHP" precisa mudar. Se não mudou, você editou o INI de outro domínio ou de outra versão de PHP.

Atualizar a base de fusos timezonedb pelo painel

A documentação da LiteSpeed para cPanel descreve o caminho: a base de fusos do PHP é mantida pela extensão timezonedb, instalada e atualizada pelo gerenciador de extensões PECL do painel, por versão de PHP (docs.litespeedtech.com).

Na prática, para quem tem acesso ao WHM ou ao cPanel com o módulo de extensões:

Identifique a versão de PHP que o site usa de fato

Use a linha Versao do PHP da página de teste. A extensão precisa ser instalada exatamente nessa versão. Instalar no PHP 8.1 não ajuda um site rodando em PHP 8.2.

Instale ou atualize a timezonedb no gerenciador PECL

No WHM, em Software > Module Installers, escolha PHP PECL e selecione a versão. Procure por timezonedb e instale ou atualize.

Confirme a nova versão da base na página de teste

Recarregue teste-fuso.php e olhe a linha Versao da timezonedb. O número precisa ter subido. Se não subiu, o PHP ainda não recarregou a extensão ou ela foi instalada em outra versão.

Se a hospedagem não expõe o gerenciador de extensões para a sua conta, esse passo é do suporte. Peça citando a versão exata de PHP e a versão de timezonedb que a sua página de teste imprimiu. Com esses dois dados, o atendimento resolve em uma mensagem em vez de três.

Testar uma camada por vez e apagar a página depois

Depois de cada ajuste, repita o mesmo teste: recarregue teste-fuso.php, crie um pedido ou agendamento de teste e compare o horário gravado com o relógio do seu celular. Mude uma camada por vez. Se mexer nas três juntas e der certo, você não sabe o que resolveu, e o problema volta no próximo servidor.

Quando terminar, apague teste-fuso.php. Ela expõe versão de PHP e detalhes do ambiente para qualquer pessoa que adivinhe a URL. Não é uma falha grave, mas é informação de graça para quem está varrendo a internet atrás de alvo. Guarde uma cópia do arquivo no seu computador para a próxima vez.

E o último lembrete, porque é o erro mais caro desta lista: antes de editar functions.php ou qualquer arquivo de configuração, faça backup completo do site e do banco. Um ponto e vírgula fora do lugar derruba a página inteira, e restaurar backup é um minuto enquanto editar às cegas pelo FTP é uma tarde.

Referências

  1. Documentação oficial (litespeed) — PHP timezonedb (LiteSpeed cPanel). Consultado em 2026-10-08.
Leia também