全部產品
Search
文件中心

MaxCompute:FORMAT_STRING

更新時間:Aug 12, 2025

按照指定的format格式說明符,將輸入的不同類型資料轉換為格式化的字串表示。

命令格式

STRING  FORMAT_STRING(STRING <format>, BIGINT|INT|SMALLINT|STRING|ARRAY <value>)

參數說明

  • format:必填。STRING類型。格式說明符。當前支援的取值有:

    • %d:進行數字格式化,輸出簡單整數格式。

    • %'d:進行數字格式化,輸出添加千位分隔字元的整數格式。

    • %0<number>d:進行數字格式化,輸出寬度為<number>,左側由零填充的的整數格式。

    • %s:進行字串格式化。

    • %t:將任何類型(如ARRAY)轉換為STRING類型,返回對應的字串值。

  • value:必填。BIGINT、INT、SMALLINT、STRING或ARRAY資料類型。要格式化的值。

傳回值說明

返回STRING類型。當format或value為NULL時,返回報錯。

使用樣本

-- 返回 12,345,678  -- 顯示帶千位分隔的整數
SELECT FORMAT_STRING("%'d", 12345678L);

-- 返回 12345678  -- 顯示為普通整數
SELECT FORMAT_STRING("%d", 12345678L);

-- 返回 hello,Tom  -- 格式化字串
SELECT FORMAT_STRING('hello,%s', 'Tom');

-- 返回 00123  -- 整數左側補零至5位
SELECT FORMAT_STRING('%05d', 123);

-- 返回 [1,2,3,4]  -- 將數群組轉換為字串格式輸出
WITH DATA AS (SELECT ARRAY(1, 2, 3, 4) AS numbers)
SELECT FORMAT_STRING('%t', numbers) AS formatted_numbers FROM DATA;

相關函數

FORMAT_STRING函數屬於字串函數,更多尋找字串、轉換字串格式的相關函數請參見字串函數。