MaxCompute:FORMAT_STRING

Sintaxe

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

Parâmetros

• format: Obrigatório. STRING que define o formato. Valores compatíveis:

  • %d: Formata um número como inteiro simples.

  • %'d: Formata um número como inteiro com separador de milhar.

  • %0<number>d: Formata um número como inteiro com largura <number>, preenchido à esquerda com zeros.

  • %s: Formata uma string.

  • %t: Converte qualquer tipo de dado, como ARRAY, para STRING.

• value: Obrigatório. Valor a formatar. O tipo de dado pode ser BIGINT, INT, SMALLINT, STRING ou ARRAY.

Valor de retorno

Retorna uma STRING. Se format ou value for NULL, a função retornará um erro.

Exemplos

-- Returns 12,345,678. -- Displays an integer with a thousands separator.
SELECT FORMAT_STRING("%'d", 12345678L);

-- Returns 12345678. -- Displays a simple integer.
SELECT FORMAT_STRING("%d", 12345678L);

-- Returns hello,Tom. -- Formats a string.
SELECT FORMAT_STRING('hello,%s', 'Tom');

-- Returns 00123. -- Left-pads an integer with zeros to a width of 5.
SELECT FORMAT_STRING('%05d', 123);

-- Returns [1,2,3,4]. -- Converts an array to a string and outputs the string.
WITH DATA AS (SELECT ARRAY(1, 2, 3, 4) AS numbers)
SELECT FORMAT_STRING('%t', numbers) AS formatted_numbers FROM DATA;

Funções relacionadas

FORMAT_STRING é uma função de string. Para obter mais informações sobre funções de busca e conversão de formatos de string, consulte String Functions Overview.