按照指定的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函數屬於字串函數,更多尋找字串、轉換字串格式的相關函數請參見字串函數。