CAST(value AS type) mengonversi nilai ke tipe lain, dan value::type adalah bentuk PostgreSQL yang lebih pendek untuk hal yang sama. '42'::integer dan CAST('42' AS integer) sama-sama mengembalikan integer 42. Bentuk ketiga, type 'literal' (seperti date '2026-11-17'), hanya berlaku untuk konstanta.
Teks '2026-11-17' menjadi tanggal, jadi menambahkan 30 menghasilkan tanggal 30 hari kemudian. 'yes' adalah salah satu ejaan yang diterima boolean, bersama true, t, on, dan 1.
Mengonversi teks ke angka atau tanggal
Data yang dimuat dari file CSV atau formulir sering datang sebagai teks. Lakukan cast sebelum membandingkan atau menghitung, karena jika dibandingkan sebagai teks, '10' berada sebelum '9':
Diurutkan sebagai integer, 9 berada sebelum 10, dan total per barisnya 40.5 dan 120. Spasi di awal dan akhir diizinkan (' 42 '::integer berjalan), tapi karakter nyasar lainnya memunculkan "invalid input syntax for type integer". Untuk teks dalam format lain, seperti '17/11/2026' atau '1,234.50', pakai to_date dan to_number dengan pola format.
Pembulatan dan pembagian integer
Cast numeric ke integer membulatkan setengah menjauhi nol. Cast nilai double precision membulatkan setengah ke bilangan genap. Pembagian integer membuang pecahannya:
Hasilnya 3, -3, 2, 4, 3, 3.5, dan 12. Pakai trunc() atau floor() sebelum cast saat kamu ingin memotong pecahan alih-alih membulatkannya.
Cast ke tipe yang lebih kecil memeriksa rentangnya: 70000::smallint gagal dengan "smallint out of range", dan 12.345::numeric(5, 2) dibulatkan menjadi 12.35.
Memeriksa input sebelum cast
Cast yang gagal menghentikan seluruh pernyataan. Sejak PostgreSQL 16, pg_input_is_valid(text, type) menguji apakah sebuah cast akan berhasil, dan pg_input_error_info mengembalikan pesan error tanpa memunculkannya:
Hanya '42' yang merupakan integer valid. '2026-02-30' terlihat seperti tanggal tapi bukan, jadi valid_date juga false untuknya. Untuk baris NULL, setiap kolom bernilai NULL, karena cast NULL menghasilkan NULL bertipe baru.
Saat PostgreSQL melakukan cast untukmu
Literal bertanda kutip belum punya tipe sampai PostgreSQL melihat di mana literal itu dipakai. Jadi WHERE id = '5' dan '1' + 1 berjalan, dengan literal dibaca sebagai integer. Nilai yang sudah punya tipe tidak dikonversi untukmu. '1'::text + 1 gagal dengan "operator does not exist: text + integer", begitu juga membandingkan kolom text dengan kolom integer. Tambahkan cast-nya sendiri.
Penulisan lebih longgar. INSERT atau UPDATE mengonversi nilai ke tipe kolom jika ada assignment cast, jadi memasukkan numeric 12.7 ke kolom integer menyimpan 13.
Untuk mengubah tipe kolom secara permanen, lakukan cast pada setiap baris sekali dengan ALTER TABLE ... ALTER COLUMN ... TYPE ... USING:
ALTER TABLE imports ALTER COLUMN qty TYPE integer USING qty::integer;
Halaman tipe data memuat daftar tipe yang bisa menjadi tujuan cast.
Pertanyaan yang sering diajukan
Apa arti :: di PostgreSQL?
Itu operator cast milik PostgreSQL: '42'::integer mengonversi teks '42' menjadi integer. Hasilnya sama dengan bentuk standar CAST('42' AS integer).
Sebaiknya memakai CAST atau :: di PostgreSQL?
Perilakunya sama. :: lebih pendek dan umum di kode PostgreSQL. CAST(... AS ...) adalah SQL standar yang juga diterima MySQL, SQL Server, dan SQLite, jadi pakai bentuk itu di query yang harus tetap portabel.
Bagaimana cara melakukan cast tanpa error saat teksnya bukan angka?
Uji dulu. Sejak PostgreSQL 16, pg_input_is_valid('4x2', 'integer') mengembalikan false alih-alih memunculkan error, jadi CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END memberi NULL untuk input yang salah. Di versi lama, periksa dulu teksnya dengan regex seperti s ~ '^-?\d+$'.
Kenapa 7 / 2 menghasilkan 3 di PostgreSQL?
Membagi dua integer menghasilkan integer dan membuang pecahannya. Cast salah satu sisi ke numeric untuk mendapat 3.5: 7::numeric / 2.