PostgreSQL 22008: valor de campo de data/hora fora do intervalo
Uma data ou hora tinha um campo fora do seu intervalo válido, como mês 13 ou dia 31 em um mês de 30 dias, ou uma confusão na ordem dia/mês.
- SQLSTATE
22008- Nome
datetime_field_overflow- Categoria
- Exceção de dados
O que significa
A entrada parecia uma data ou hora, mas um dos seus campos é impossível: um mês maior que 12, um dia que não existe naquele mês, uma hora maior que 24. 22008 (datetime_field_overflow) também cobre resultados fora do intervalo representável, como timestamp out of range.
Quando o valor é uma data numérica como 13/01/2026, o PostgreSQL adiciona uma dica de que você pode precisar de um DateStyle, porque ele leu 13 como o mês.
Causas comuns
- Dia e mês trocados em relação ao
DateStyle. - Datas de calendário inválidas nos dados de origem, como 30 de fevereiro.
- Aritmética de datas que produz um valor fora do intervalo suportado.
Como corrigir
-
Use datas no padrão ISO 8601 (
YYYY-MM-DD), que nunca são ambíguas. -
Se a data vier com o dia primeiro, diga isso, ou a interprete com um formato explícito.
SET DateStyle = 'ISO, DMY'; SELECT '13/01/2026'::date; -- or SELECT to_date('13/01/2026', 'DD/MM/YYYY'); -
Encontre linhas incorretas em uma tabela de staging antes de convertê-las (PostgreSQL 16 ou superior).
SELECT raw_date FROM staging WHERE NOT pg_input_is_valid(raw_date, 'date');
Reproduza com segurança
SELECT '2026-02-30'::date; -- ERROR: date/time field value out of range: "2026-02-30"
Erros relacionados
22007formato de data/hora inválido22003valor numérico fora do intervalo242SQL Server: Conversão de data fora do intervalo1292MySQL: valor incorreto truncadoORA-01843Oracle: mês inválido
Mais erros de exceção de dados
22021sequência de bytes inválida para a codificação22012divisão por zero22023valor de parâmetro inválido22001valor muito longo para o tipo22P02sintaxe de entrada inválida para o tipo
O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.
Trabalhe com PostgreSQL no SQLly
Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.