MaxCompute:FORMAT_STRING

構文

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 は文字列関数です。文字列の検索と文字列フォーマットの変換を行う関数の詳細については、「文字列関数」をご参照ください。