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.
Nota
Not all functions are supported between Standard mode and Cloud Native mode tools. For a list of supported functions, go to the respective Standard mode and Could Native mode function lists found on the Formula tool page.
BinToInt(s)
: converte a cadeia de caracteres binária s em um número inteiro (limitado a 53 bits).
BinToInt(101010101)
resulta em 341.
CharFromInt(x)
: retorna o caractere Unicode® que corresponde ao número fornecido em x.
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(s)
: retorna o número que corresponde ao caractere Unicode® fornecido em s.
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(s, codePage): Translates text from a code page to Unicode. To learn more about code pages, go to the Code Pages documentation.
ConvertToCodePage(s, codePage): Translates text from Unicode encoding to a specific code page. To learn more about code pages, visit the Code Pages documentation.
HexToNumber(x)
: converte uma cadeia de caracteres hexadecimal em um número (limitado a 53 bits).
HexToNumber(dd)
converte para o número 221.
IntToBin(x)
: converte x em uma cadeia de caracteres binária.
IntToHex(x)
: converte x em uma cadeia de caracteres hexadecimal.
ToDegrees(x): Converts a numeric radian value (x) to degrees via the (x)rad × 180/π calculation. Please note that x must be a numeric value and can’t include any radian symbol (rad).
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.
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.
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(x): Converts a numeric degree value (x) to radians via the (x)° × π/180 calculation. Please note that x must be a numeric value and can’t include the degree symbol (°).
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.
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.
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(String, Form): Converts text data in the provided string into a standardized Unicode form. Use the required Form parameter (case-insensitive) to define the normalization form. You must manually enter one of the below normalization form options (this parameter can't be populated via an upstream field.
Normalization helps ensure that different representations of the same text are treated equivalently. It reduces ambiguity and simplifies text processing tasks such as searching, sorting, and comparing. It's particularly important in environments where text can originate from various sources or be processed by different systems with differing encoding standards.
String: The provided string that you need to normalize.
Form: Options for how to normalize your string. These are the acceptable normalization forms (String format and quotes are required):
NFC (Normalization Form Canonical Composition): NFC composes characters and sequences of characters in a text into a single precomposed form whenever possible. This form is commonly used for data interchange and storage.
NFD (Normalization Form Canonical Decomposition): NFD decomposes characters and sequences of characters into their base characters and combines characters. This form can be useful for tasks such as searching and comparing text.
NFKC (Normalization Form Compatibility Composition): NFKC first applies a compatibility decomposition, then composes characters and sequences of characters into a single precomposed form whenever possible. This form is often used for compatibility and normalization of legacy data.
NFKD (Normalization Form Compatibility Decomposition): NFKD applies a compatibility decomposition to characters and sequences of characters, breaking them down into their base characters and combining characters. This form can also be useful for compatibility and normalization purposes.
UnicodeNormalize("i⁹","NFKD")returns i9.UnicodeNormalize("¼","NFKC")returns 1/4.UnicodeNormalize("㌄","NFC")returns ㌄.UnicodeNormalize("㌄","NFKC")returns イニング.