Funções de conversão
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 (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(
)
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.