// Referencia de errores de PostgreSQL

PostgreSQL 22008: valor de campo de fecha/hora fuera de rango

Una fecha o una hora tenía un campo fuera de su rango válido: el mes 13, el día 31 en un mes de 30 días, o el día y el mes intercambiados.

SQLSTATE
22008
Nombre
datetime_field_overflow
Categoría
Excepción de datos
Mensaje de error
date/time field value out of range: "2026-13-01"

Qué significa

La entrada parecía una fecha u hora, pero uno de sus campos es imposible: un mes superior a 12, un día que no existe en ese mes, una hora superior a 24. 22008 (datetime_field_overflow) también cubre resultados fuera del rango representable, como timestamp out of range.

Cuando el valor es una fecha numérica como 13/01/2026, PostgreSQL añade una sugerencia de que puede que necesites un DateStyle, porque leyó 13 como el mes.

Causas comunes

  • Día y mes intercambiados en relación con la DateStyle.
  • Fechas de calendario no válidas en los datos de origen, como el 30 de febrero.
  • Aritmética de fechas que produce un valor fuera del rango admitido.

Cómo solucionarlo

  1. Usa fechas ISO 8601 (YYYY-MM-DD), que nunca son ambiguas.

  2. Si los datos tienen el día primero, indícalo, o analízalos con un formato explícito.

    SET DateStyle = 'ISO, DMY';
    SELECT '13/01/2026'::date;
    -- or
    SELECT to_date('13/01/2026', 'DD/MM/YYYY');
  3. Encontrar filas incorrectas en una tabla de staging antes de convertirlas (PostgreSQL 16 y posteriores).

    SELECT raw_date FROM staging WHERE NOT pg_input_is_valid(raw_date, 'date');

Reprodúcelo de forma segura

SELECT '2026-02-30'::date;  -- ERROR: date/time field value out of range: "2026-02-30"

Errores relacionados

Más errores de excepción de datos

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.