# 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.

> 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.

João Rizzon · 2026-10-12 · WordPress

---

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](https://docs.litespeedtech.com/lsws/cp/cpanel/php-timezonedb/)). 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:

- **Offset fixo errado** (3 horas, 5 horas, sempre o mesmo desvio o ano inteiro): é fuso configurado errado em alguma camada.
- **Erro de 1 hora que aparece só em alguns meses**: é regra de horário de verão. Isso sim depende da base de fusos. Uma timezonedb antiga pode ainda aplicar um horário de verão que foi extinto, ou desconhecer uma mudança recente de offset de algum país.

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.

## 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
<?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:

- `PHP_VERSION` confirma qual versão de PHP o site está usando de fato. Nem sempre é a que você acha que selecionou.
- `ini_get('date.timezone')` mostra o valor escrito no `php.ini` daquela versão. Vazio é comum e não é erro por si só.
- `date_default_timezone_get()` mostra o fuso que o PHP está usando na prática.
- `timezone_version_get()` devolve a versão da base de fusos carregada, no formato ano.número (por exemplo `2024.1`).
- Os três `DateTime` imprimem o mesmo instante em três referências, com o offset no fim de cada linha.

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:

```php
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.

## 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](https://docs.litespeedtech.com/lsws/cp/cpanel/php-timezonedb/)).

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.

