Funções de conversão

Last modified: February 02, 2022

A documentação de ajuda está disponível antes do lançamento do Designer Cloud para que você possa dar uma olhadinha. O conteúdo pode mudar até o lançamento oficial.

Uma função de conversão converte um formato ou tipo de dados em outro formato ou tipo de dados. Por exemplo, use uma função de conversão para converter números em cadeias de caracteres ou cadeias de caracteres em números. É possível usar funções de conversão com dados de cadeias de caracteres ou números.

BinToInt

BinToInt(s): converte a cadeia de caracteres binária s em um número inteiro (limitado a 53 bits).

Exemplo

BinToInt(101010101) resulta em 341.

CharFromInt

CharFromInt(x): retorna o caractere Unicode® que corresponde ao número fornecido em x.

Exemplo

CharFromInt(66) retorna B (U+0042 "letra maiúscula latina B").

CharFromInt(169) retorna © (U+00A9 "símbolo de copyright").

CharFromInt(1071) retorna Я (U+042F "letra maiúscula cirílica YA").

CharFromInt(127944) retorna ícone de bola de futebol americano  (U+1F3C8 "Futebol americano").

CharFromInt(0) retorna [Null] (U+000 "Nulo") porque qualquer número inteiro que não pode ser usado para representar um caractere gera um resultado nulo.

CharFromInt(55300) retorna [Null] porque qualquer número inteiro que atualmente não representa um caractere não é renderizado por uma fonte normal.

CharToInt

CharToInt(s): retorna o número que corresponde ao caractere Unicode® de entrada s.

Exemplo

CharToInt("B") retorna 66 (U+0042 "letra maiúscula latina B").

CharToInt("©") retorna 169 (U+00A9 "símbolo de copyright").

CharToInt("Я") retorna 1071 (U+042F "letra maiúscula cirílica YA").

CharToInt(ícone de bola de futebol americano) retorna 127944 (U+1F3C8 "futebol americano").

ConvertFromCodePage

ConvertFromCodePage(s, codePage): traduz o texto de uma página de código para Unicode. Para saber mais sobre páginas de código, visite a documentação sobre Páginas de código.

ConvertToCodePage

ConvertToCodePage(s, codePage): traduz o texto da codificação Unicode® para uma página de código específica. Para saber mais sobre páginas de código, visite a documentação sobre Páginas de código.

HexToNumber

HexToNumber(x): converte uma cadeia de caracteres hexadecimal em um número (limitado a 53 bits).

Exemplo

HexToNumber(dd) converte para o número 221.

IntToBin

IntToBin(x): converte x em uma cadeia de caracteres binária.

IntToHex

IntToHex(x): converte x em uma cadeia de caracteres hexadecimal.

ToNumber

ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator]): converte uma cadeia de caracteres (x) em um número.

A função ToNumber aceita cadeias de caracteres que podem ser interpretadas como notação científica de precisão dupla. Por padrão, o ponto é usado como separador decimal.

Parâmetros opcionais

bIgnoreErrors 

  • (Padrão) 0 ou "false" gera mensagens de erro de conversão.
  • 1 ou "true" ignora erros de conversão.

keepNulls

  • (Padrão) 0 ou "false" converte valores não numéricos (incluindo nulos) em zero.
  • 1 ou "true" converte valores não numéricos em nulo.

decimalSeparator: é o separador decimal da cadeia de caracteres de entrada.

  • (Padrão) "." especifica o ponto como separador decimal.
  • "," especifica a vírgula como separador decimal.

O parâmetro decimalSeparator ignora qualquer que seja o separador de milhar (espaço, ponto, vírgula) definido na cadeia de caracteres de entrada.

Exemplos

ToNumber("878") retorna a cadeia de caracteres 878 como um número.

ToNumber("4.256411411E9") retorna a cadeia de caracteres 4256411411 como um número.

ToNumber("Number", "false") retorna 0 com o erro de conversão: TONUMBER: o número perdeu informações na conversão.

ToNumber("Number", 0, 0) retorna 0 com o erro de conversão: TONUMBER: o número perdeu informações na conversão.

ToNumber("Number", 1, 0) retorna 0 sem reportar erros de conversão.

ToNumber("Number", 1, 1) retorna [Null] sem reportar erros de conversão.

ToNumber("123456,789", 1, 1, ",") retorna 123456.789 como um número.

ToNumber("123.456,789", 1, 1, ",") retorna 123456.789 como um número. Isso ocorre porque o ponto é automaticamente interpretado como separador de milhar, enquanto a vírgula é especificada como separador decimal por meio do decimalSeparator.

ToString

ToString(x, numDec, [addThousandsSeparator], [decimalSeparator]): converte um parâmetro numérico (x) em uma cadeia de caracteres usando casas decimais numDec. A seleção padrão usa um ponto como o separador decimal.

Parâmetros opcionais

addThousandsSeparator

  • (Padrão) 0 formata a cadeia de caracteres numérica sem um separador de milhar.
  • 1 a formata com um separador de milhar. Por padrão, o separador de milhar é uma vírgula, a menos que "," seja especificado como decimalSeparator, caso em que o separador de milhar é um ponto.
  • "," especifica a vírgula como separador de milhar.
  • "." especifica o ponto como separador de milhar.
  • " " especifica um espaço como o separador de milhar.
  • "'" especifica o apóstrofo como separador de milhar.

decimalSeparator:

  • (Padrão) "." especifica o ponto como separador decimal.
  • "," especifica a vírgula como separador decimal.

Exemplos

ToString(10, 0) retorna 10 como uma cadeia de caracteres.

ToString(10.4, 2) retorna 10.40 como uma cadeia de caracteres.

ToString(100.4, 2) retorna 100.40 como uma cadeia de caracteres.

ToString(1000.4, 2, 1) retorna 1,000.40 como uma cadeia de caracteres.

ToString(123456.789, 3, 1, ",") retorna 123.456,789 como uma cadeia de caracteres.

ToString(123456.789, 3, 0, ",") retorna 123456,789 como uma cadeia de caracteres.

ToString(1234567.89, 2, ".", ",") retorna 1.234.567,89 como uma cadeia de caracteres.

ToString(1234567.89, 2, " ", ",") retorna 1 234 567,89 como uma cadeia de caracteres.

ToString(1234567.89, 2, "'", ",") retorna 1'234'567,89 como uma cadeia de caracteres.

Esta página foi útil?

Problemas com seu produto Alteryx? Visite a Comunidade Alteryx ou entre em contato com nossa Equipe de Suporte. Não é possível enviar este formulário? Envie-nos um e-mail.