Funções de conversão do fluxo de trabalho
Uma função de conversão converte um formato ou tipo de dados em outro. Por exemplo, use uma função 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 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(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").
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, acesse 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.
ToDegrees
ToDegrees(x): converte um valor numérico (x) radiano para graus por meio do cálculo (x)rad × 180/π. Observe que x deve ser um valor numérico e não pode incluir o símbolo de radiano (rad).
ToNumber
ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator]): converte uma cadeia de caracteres (x) em um número. Os colchetes indicam parâmetros opcionais.
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 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) 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 está especificada como separador decimal por meio do parâmetro decimalSeparator.
ToRadians
ToRadians(x): converte um valor de grau numérico (x) em radianos através do cálculo (x)° × π/180. Observe que x deve ser um valor numérico e não pode incluir o símbolo de grau (°).
ToString
ToString(x, numDec, [addThousandsSeparator], [decimalSeparator]): converte um parâmetro numérico (x) em uma cadeia de caracteres que usa as casas decimais especificadas em numDec. A seleção padrão usa um ponto como o separador decimal. Os colchetes indicam parâmetros opcionais.
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.
UnicodeNormalize
UnicodeNormalize(String, Form): converte dados de texto na cadeia de caracteres fornecida em um formulário Unicode padronizado. Use o parâmetro obrigatório "Form" (não diferencia maiúsculas e minúsculas) para definir a forma de normalização. Você deve inserir manualmente uma das opções de forma de normalização abaixo (esse parâmetro não pode ser preenchido por um campo em etapas anteriores).
A normalização ajuda a garantir que diferentes representações do mesmo texto sejam tratadas de maneira equivalente. Ela reduz ambiguidades e simplifica tarefas de processamento de texto, como pesquisa, ordenação e comparação. É particularmente importante em ambientes onde o texto pode se originar de diversas fontes ou ser processado por diferentes sistemas com padrões de codificação variados.
Parâmetros
String: a cadeia de caracteres fornecida que você precisa normalizar.
Form: opções para normalizar a cadeia de caracteres. Estas são as formas (forms) de normalização aceitáveis (formato de string e aspas retas são obrigatórios):
NFC (forma de normalização canônica por composição): NFC compõe caracteres e sequências de caracteres em um texto em uma única forma pré-composta sempre que possível. Essa forma é comumente usada para intercâmbio e armazenamento de dados.
NFD (forma de normalização canônica por decomposição): NFD decompõe caracteres e sequências de caracteres em seus caracteres base e combina caracteres. Essa forma pode ser útil para tarefas como pesquisa e comparação de texto.
NFKC (forma de normalização por composição de compatibilidade): NFKC aplica primeiro uma decomposição de compatibilidade e depois compõe os caracteres e sequências de caracteres em uma única forma pré-composta sempre que possível. Essa forma é frequentemente usada para compatibilidade e normalização de dados herdados.
NFKD (forma de normalização por decomposição de compatibilidade): NFKD aplica uma decomposição de compatibilidade aos caracteres e sequências de caracteres, separando-os em seus caracteres base e em caracteres combinados. Essa forma também pode ser útil para fins de compatibilidade e normalização.
Exemplo
UnicodeNormalize("i⁹","NFKD")retorna i9.UnicodeNormalize("¼","NFKC")retorna 1/4.UnicodeNormalize("㌄","NFC")retorna ㌄.UnicodeNormalize("㌄","NFKC")retorna イニング.