Função de ER NUMERALSTOTEXT
A função NUMERALSTOTEXT
retorna o número especificado como um valor de Cadeia de caracteres após ele ser soletrado (ou seja, convertido em cadeias de caracteres de texto) no idioma especificado.
Sintaxe
NUMERALSTOTEXT (number, language, currency, print currency name flag, decimal points)
Argumentos
number
: Inteiro ou Real
Um valor numérico que especifica o número que deve ser soletrado.
language
: Cadeia de caracteres
Um valor de Cadeia de caracteres que representa o código de idioma.
currency
: Cadeia de caracteres
Um valor de Cadeia de caracteres que representa o código de moeda.
print currency name flag
: Booliano
Um valor Booliano que indica se um nome de moeda deve ser adicionado ao texto soletrado.
decimal points
: Inteiro
Um valor Inteiro que indica o número de casas decimais que o texto soletrado deve ter.
Valores de retorno
Sequência de caracteres
O valor de texto resultante.
Notas de uso
O código de idioma é opcional. Se for definido como uma cadeia de caracteres vazia, o código de idioma do contexto em execução será utilizado. O código de idioma padrão é EN-US. O código de idioma do contexto em execução é definido em um elemento Pasta ou Arquivo do formato de relatório eletrônico (ER) que está sendo executado.
O código de moeda é opcional. Se for definido como uma cadeia de caracteres vazia, a moeda da empresa do contexto em execução será utilizada.
Observação
Os argumentos print currency name flag
e decimal points
são analisados somente para os seguintes códigos de idioma: CS, ET, HU, LT, LV, PL e RU. Além disso, o argumento print currency name flag
é analisado somente para empresas nas quais o contexto do país ou da região ofereça suporte a variações de nomes de moeda.
Exemplo 1
NUMERALSTOTEXT (1234.56, "EN-US", "", false, 2)
retorna "One Thousand Two Hundred Thirty Four and 56".
Exemplo 2
NUMERALSTOTEXT (120, "PL", "", false, 0)
retorna "Sto dwadzieścia".
Exemplo 3
NUMERALSTOTEXT (120.21, "RU", "EUR", true, 2)
retorna "Сто двадцать евро 21 евроцент".