CAST(value AS type) wandelt einen Wert in einen anderen Typ um, und value::type ist die kürzere Form von PostgreSQL für dasselbe. '42'::integer und CAST('42' AS integer) liefern beide den Integer 42. Eine dritte Form, type 'literal' (wie in date '2026-11-17'), funktioniert nur für Konstanten.
Der Text '2026-11-17' wird zu einem Datum, plus 30 ergibt also das Datum 30 Tage später. 'yes' ist eine der Schreibweisen, die boolean akzeptiert, neben true, t, on und 1.
Text in eine Zahl oder ein Datum umwandeln
Daten aus CSV-Dateien oder Formularen kommen oft als Text an. Caste sie, bevor du vergleichst oder rechnest, denn als Text verglichen steht '10' vor '9':
Als Integer sortiert kommt 9 vor 10, und die Zeilensummen sind 40.5 und 120. Leerzeichen am Anfang und Ende sind erlaubt (' 42 '::integer funktioniert), aber jedes andere überzählige Zeichen löst "invalid input syntax for type integer" aus. Für Text in einem anderen Format, etwa '17/11/2026' oder '1,234.50', nimmst du to_date und to_number mit einem Formatmuster.
Runden und Integer-Division
Ein Cast von numeric nach Integer rundet bei .5 von null weg. Ein Cast von double precision rundet bei .5 zur geraden Zahl. Die Integer-Division schneidet den Nachkommateil ab:
Die Ergebnisse sind 3, -3, 2, 4, 3, 3.5 und 12. Nimm trunc() oder floor() vor dem Cast, wenn du den Nachkommateil abschneiden statt runden willst.
Ein Cast in einen kleineren Typ prüft den Wertebereich: 70000::smallint scheitert mit "smallint out of range", und 12.345::numeric(5, 2) wird auf 12.35 gerundet.
Eingabe vor dem Cast prüfen
Ein fehlgeschlagener Cast stoppt die ganze Anweisung. Seit PostgreSQL 16 prüft pg_input_is_valid(text, type), ob ein Cast gelingen würde, und pg_input_error_info liefert die Fehlermeldung, ohne den Fehler auszulösen:
Nur '42' ist ein gültiger Integer. '2026-02-30' sieht aus wie ein Datum, ist aber keins, daher ist valid_date auch hier falsch. In der NULL Zeile ist jede Spalte NULL, denn ein Cast von NULL ergibt NULL im neuen Typ.
Wann PostgreSQL selbst castet
Ein Literal in Anführungszeichen hat keinen Typ, bis PostgreSQL sieht, wo es verwendet wird. Deshalb funktionieren WHERE id = '5' und '1' + 1, das Literal wird als Integer gelesen. Ein Wert, der schon einen Typ hat, wird nicht für dich umgewandelt. '1'::text + 1 scheitert mit "operator does not exist: text + integer", und genauso der Vergleich einer text Spalte mit einer integer Spalte. Schreib den Cast selbst dazu.
Beim Schreiben ist PostgreSQL großzügiger. Ein INSERT oder UPDATE wandelt einen Wert in den Typ der Spalte um, wenn es einen Zuweisungs-Cast gibt. Der numeric-Wert 12.7 in einer Integer-Spalte wird also als 13 gespeichert.
Um den Typ einer Spalte dauerhaft zu ändern, castest du jede Zeile einmal mit ALTER TABLE ... ALTER COLUMN ... TYPE ... USING:
ALTER TABLE imports ALTER COLUMN qty TYPE integer USING qty::integer;
Die Seite zu den Datentypen listet die Typen auf, in die du casten kannst.
Häufig gestellte Fragen
Was bedeutet :: in PostgreSQL?
Das ist der Cast-Operator von PostgreSQL: '42'::integer wandelt den Text '42' in einen Integer um. Er macht dasselbe wie das Standard-SQL CAST('42' AS integer).
Soll ich in PostgreSQL CAST oder :: verwenden?
Beide verhalten sich gleich. :: ist kürzer und in PostgreSQL-Code verbreitet. CAST(... AS ...) ist Standard-SQL, das auch MySQL, SQL Server und SQLite verstehen. Nimm es in Abfragen, die portabel bleiben müssen.
Wie caste ich ohne Fehler, wenn der Text keine Zahl ist?
Prüf ihn vorher. Seit PostgreSQL 16 liefert pg_input_is_valid('4x2', 'integer') false statt eines Fehlers, also ergibt CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END bei ungültiger Eingabe NULL. In älteren Versionen prüfst du den Text zuerst mit einem Regex wie s ~ '^-?\d+$'.
Warum liefert 7 / 2 in PostgreSQL 3?
Die Division zweier Integer ergibt einen Integer, der Nachkommateil fällt weg. Caste eine Seite nach numeric, um 3.5 zu bekommen: 7::numeric / 2.