Menu

PostgreSQL の CAST と :: による型変換

PostgreSQL では CAST(value AS type) と value::type で値を別の型に変換します。どちらも同じ変換で、:: は PostgreSQL の短い書き方です。

このページのコードはエディタで実行できます。編集してすぐに結果を確認できます。

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。

Coddyのプログラミング言語のイラスト

Coddyでコードを学ぼう

始める