All Products
Search
Document Center

MaxCompute:FORMAT_STRING

Last Updated:Oct 23, 2025

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.