CAST(value AS type) は値を別の型に変換し、value::type は同じことを PostgreSQL で短く書く形です。'42'::integer も CAST('42' AS integer) も整数の 42 を返します。3 つ目の形 type 'literal' (date '2026-11-17' など) は定数にだけ使えます。
テキストの '2026-11-17' は日付になるので、30 を足すと 30 日後の日付になります。'yes' は boolean が受け付ける書き方の 1 つで、ほかに true、t、on、1 があります。
テキストを数値や日付に変換する
CSV ファイルやフォームから読み込んだデータは、テキストで届くことがよくあります。比較や計算の前にキャストしてください。テキストとして比べると、'10' は '9' より前に並びます。
整数として並べると 9 が 10 より前に来て、明細の合計は 40.5 と 120 です。前後のスペースは許されます (' 42 '::integer は動きます) が、それ以外の余計な文字があると "invalid input syntax for type integer" というエラーになります。'17/11/2026' や '1,234.50' のような別の形式のテキストには、書式パターンを付けて to_date と to_number を使ってください。
丸めと整数の割り算
numeric を整数にキャストすると、0.5 はゼロから遠い方向に丸められます。double precision の値をキャストすると、0.5 は偶数に丸められます。整数の割り算は小数部分を切り捨てます。
結果は 3、-3、2、4、3、3.5、12 です。丸めずに小数部分を切り捨てたいときは、キャストの前に trunc() か floor() を使ってください。
小さい型へのキャストでは範囲がチェックされます。70000::smallint は "smallint out of range" で失敗し、12.345::numeric(5, 2) は 12.35 に丸められます。
キャストの前に入力をチェックする
キャストが失敗すると、文全体が止まります。PostgreSQL 16 からは、pg_input_is_valid(text, type) でキャストが成功するかを判定でき、pg_input_error_info はエラーを出さずにエラーメッセージを返します。
正しい整数は '42' だけです。'2026-02-30' は日付に見えますが日付ではないので、valid_date も false になります。NULL をキャストすると新しい型の NULL になるので、NULL の行はすべての列が NULL です。
PostgreSQL が自動でキャストする場合
引用符で囲んだリテラルは、PostgreSQL が使われ方を見るまで型を持ちません。そのため WHERE id = '5' や '1' + 1 は動き、リテラルは整数として読まれます。すでに型を持つ値は自動では変換されません。'1'::text + 1 は "operator does not exist: text + integer" で失敗し、text の列と integer の列を比べた場合も同じです。自分でキャストを加えてください。
書き込みはもっと寛容です。INSERT や UPDATE は、代入キャストがあれば値を列の型に変換するので、integer の列に numeric の 12.7 を挿入すると 13 が保存されます。
列の型を恒久的に変えるには、ALTER TABLE ... ALTER COLUMN ... TYPE ... USING ですべての行を一度だけキャストします。
ALTER TABLE imports ALTER COLUMN qty TYPE integer USING qty::integer;
キャストできる型は データ型のページ にまとめています。
よくある質問
PostgreSQL の :: は何を意味しますか?
PostgreSQL のキャスト演算子です。'42'::integer はテキストの '42' を整数に変換します。標準の CAST('42' AS integer) と同じ働きです。
PostgreSQL では CAST と :: のどちらを使うべきですか?
動作は同じです。:: は短く、PostgreSQL のコードでよく使われます。CAST(... AS ...) は MySQL、SQL Server、SQLite も受け付ける標準 SQL なので、移植性を保ちたいクエリではこちらを使ってください。
テキストが数値でないときにエラーを出さずにキャストするには?
先に判定します。PostgreSQL 16 からは、pg_input_is_valid('4x2', 'integer') がエラーを出さずに false を返すので、CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END で不正な入力を NULL にできます。古いバージョンでは、先に s ~ '^-?\d+$' のような正規表現でテキストを確認してください。
PostgreSQL で 7 / 2 が 3 になるのはなぜですか?
整数どうしの割り算は整数を返し、小数部分を切り捨てます。3.5 を得るには、片方を numeric にキャストします: 7::numeric / 2。