// Referência de erro do PostgreSQL

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
Mensagem de erro
date/time field value out of range: "2026-13-01"

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

  1. Use datas no padrão ISO 8601 (YYYY-MM-DD), que nunca são ambíguas.

  2. 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');
  3. 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

Mais erros de exceção de dados

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.

// menos erros, correções mais rápidas

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.