Funções de conversão

Versão:
2022.3
Last modified: July 21, 2022

Uma função de conversão converte um formato ou tipo de dados em outro. Use funções de conversão para converter números em cadeias de caracteres ou cadeias de caracteres em números. Funções de conversão podem ser utilizadas com dados de cadeias de caracteres ou numéricos.

BinToInt

BinToInt(s): converte uma cadeia de caracteres binária (s) em um número inteiro. É limitado a 53 bits de precisão e pode ter até 64 bits de tamanho. Isso significa que você pode ter, por exemplo, uma cadeia de caracteres de 53 1 bits com 10 0 bits.

Exemplo

BinToInt("101010101") resulta em 341.

Se a cadeia de entrada tiver exatamente 32 ou 64 caracteres, ela será tratada como um número com sinal:
BinToInt("11111111111111111111111111111011") resulta em -5.

Os sinais à esquerda "+" e "-" têm precedência sobre o tratamento de 32 e 64 caracteres como um número com sinal: 
BinToInt("-111") resulta em -7,

BinToInt("+111") resulta em 7.

Todos os exemplos a seguir dão o mesmo resultado de 9,223,372,036,854,774,784 ou 0x7FFFFFFFFFFFFC00:
​​​​​​BinToInt("111111111111111111111111111111111111111111111111111101000000001") arredonda para cima,

BinToInt("111111111111111111111111111111111111111111111111111110000000000") fica exato,

BinToInt("111111111111111111111111111111111111111111111111111110111111111") arredonda para baixo.

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 "bola de 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 pode ser renderizado por uma fonte normal.

CharToInt

CharToInt(s): retorna o número que corresponde ao caractere Unicode® fornecido em 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 "bola de 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 um texto de 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.

Valores não numéricos

A função ToNumber avalia a cadeia de caracteres desde o início e para quando encontra um valor não numérico (com exceção de vírgulas, pontos, espaços e apóstrofos).

Por exemplo, a cadeia de caracteres "June 2022" retorna 0 ou [Null] (dependendo da configuração), enquanto "2022 June" retorna 2022.

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 um 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 ou apóstrofo) da 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 está especificada como separador decimal por meio do parâmetro decimalSeparator.

ToNumber("June 2022") retorna 0. A função encontra um valor não numérico logo no início e o converte em 0.

ToNumber("2022 June") retorna 2022 como um número. A função para quando encontra um valor não numérico, o J em "June".

ToNumber("6/1/2022") retorna 6 como um número. A função para quando encontra um valor não numérico, o /.

ToNumber("2022 5:00:00") retorna 20225 como um número. A função para quando encontra um valor não numérico, o : após o número 5.

ToString

ToString(x, numDec, [addThousandsSeparator], [decimalSeparator]): converte um parâmetro numérico (x) em uma cadeia de caracteres usando as casas decimais especificadas em 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.