Fungsi FORMAT_STRING mengonversi data dari berbagai tipe menjadi string terformat sesuai dengan format string yang ditentukan.
Sintaksis
STRING FORMAT_STRING(STRING <format>, BIGINT|INT|SMALLINT|STRING|ARRAY <value>)Parameter
format: Wajib. STRING yang menentukan format. Nilai yang didukung meliputi:
%d: Memformat angka sebagai bilangan bulat sederhana.%'d: Memformat angka sebagai bilangan bulat dengan pemisah ribuan.%0<number>d: Memformat angka sebagai bilangan bulat dengan lebar <number>, diisi nol di sebelah kiri.%s: Memformat string.%t: Mengonversi semua tipe data, seperti ARRAY, menjadi STRING.
value: Wajib. Nilai yang akan diformat. Tipe datanya bisa BIGINT, INT, SMALLINT, STRING, atau ARRAY.
Nilai pengembalian
Mengembalikan STRING. Jika format atau value adalah NULL, kesalahan akan dikembalikan.
Contoh
-- Mengembalikan 12.345.678. -- Menampilkan bilangan bulat dengan pemisah ribuan.
SELECT FORMAT_STRING("%'d", 12345678L);
-- Mengembalikan 12345678. -- Menampilkan bilangan bulat sederhana.
SELECT FORMAT_STRING("%d", 12345678L);
-- Mengembalikan hello,Tom. -- Memformat string.
SELECT FORMAT_STRING('hello,%s', 'Tom');
-- Mengembalikan 00123. -- Mengisi bilangan bulat dengan nol di sebelah kiri hingga lebar 5.
SELECT FORMAT_STRING('%05d', 123);
-- Mengembalikan [1,2,3,4]. -- Mengonversi array menjadi string dan mengeluarkan string tersebut.
WITH DATA AS (SELECT ARRAY(1, 2, 3, 4) AS numbers)
SELECT FORMAT_STRING('%t', numbers) AS formatted_numbers FROM DATA;Fungsi terkait
FORMAT_STRING adalah fungsi string. Untuk informasi lebih lanjut tentang fungsi untuk mencari string dan mengonversi format string, lihat Fungsi string.