// PostgreSQL-Fehlerreferenz

PostgreSQL 22008: Datums-/Uhrzeitfeldwert außerhalb des gültigen Bereichs

Ein Datum oder eine Uhrzeit hatte ein Feld außerhalb seines gültigen Bereichs, etwa Monat 13 oder Tag 31 in einem 30-Tage-Monat, oder Tag und Monat waren vertauscht.

SQLSTATE
22008
Name
datetime_field_overflow
Kategorie
Daten-Ausnahme
Fehlermeldung
date/time field value out of range: "2026-13-01"

Was es bedeutet

Die Eingabe sah wie ein Datum oder eine Uhrzeit aus, aber eines ihrer Felder ist unmöglich: ein Monat über 12, ein Tag, der in diesem Monat nicht existiert, eine Stunde über 24. 22008 (datetime_field_overflow) deckt auch Ergebnisse außerhalb des darstellbaren Bereichs ab, wie zum Beispiel timestamp out of range.

Wenn der Wert ein numerisches Datum ist wie 13/01/2026, fügt PostgreSQL einen Hinweis hinzu, dass du möglicherweise ein anderes DateStyle, weil es 13 als Monat gelesen hat.

Häufige Ursachen

  • Tag und Monat vertauscht relativ zum DateStyle.
  • Ungültige Kalendertage in den Quelldaten, wie der 30. Februar.
  • Datumsarithmetik, die einen Wert außerhalb des unterstützten Bereichs erzeugt.

Wie du es behebst

  1. Verwende ISO-8601-Datumsangaben (YYYY-MM-DD), die niemals mehrdeutig sind.

  2. Wenn der Tag vorne steht, sag das, oder pars sie mit einem expliziten Format.

    SET DateStyle = 'ISO, DMY';
    SELECT '13/01/2026'::date;
    -- or
    SELECT to_date('13/01/2026', 'DD/MM/YYYY');
  3. Finde fehlerhafte Zeilen in einer Staging-Tabelle, bevor du sie konvertierst (PostgreSQL 16 und höher).

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

Sicher reproduzieren

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

Zugehörige Fehler

Weitere Fehler bei Daten-Exceptions

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.