// справочник ошибок PostgreSQL

PostgreSQL 22008: значение поля даты/времени вне диапазона

В дате или времени поле вышло за допустимый диапазон: например, месяц 13, день 31 в 30-дневном месяце или перепутанный порядок день/месяц.

SQLSTATE
22008
Имя
datetime_field_overflow
Категория
Исключение данных
Сообщение об ошибке
date/time field value out of range: "2026-13-01"

Что это значит

Ввод выглядел как дата или время, но одно из его полей невозможно: месяц больше 12, день, который не существует в этом месяце, час больше 24. 22008 (datetime_field_overflow) также охватывает результаты за пределами представимого диапазона, такие как timestamp out of range.

Когда значение является числовой датой, например 13/01/2026, PostgreSQL добавляет подсказку о том, что вам может понадобиться другой DateStyle, потому что он интерпретировал 13 как месяц.

Распространённые причины

  • День и месяц поменяны местами относительно DateStyle.
  • Недопустимые календарные даты в исходных данных, например 30 февраля.
  • Арифметика дат, которая приводит к значению за пределами поддерживаемого диапазона.

Как исправить

  1. Используйте даты в формате ISO 8601 (YYYY-MM-DD), которые никогда не являются двусмысленными.

  2. Если в данных день стоит первым, скажите об этом или разберите их с явным форматом.

    SET DateStyle = 'ISO, DMY';
    SELECT '13/01/2026'::date;
    -- or
    SELECT to_date('13/01/2026', 'DD/MM/YYYY');
  3. Находите проблемные строки в промежуточной таблице до их преобразования (PostgreSQL 16 и новее).

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

Безопасное воспроизведение

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

Связанные ошибки

Больше ошибок данных

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.