Função de ER NUMERALSTOTEXT
A função NUMERALSTOTEXT devolve o número especificado como um valor Cadeia depois de ter sido escrito por extenso (isto é, convertido em cadeias de texto) no idioma especificado.
Sintaxe
NUMERALSTOTEXT (number, language, currency, print currency name flag, decimal points)
Argumentos
number: Número inteiro ou Real
Um valor numérico que especifica o número que tem de ser escrito por extenso.
language: Cadeia
Um valor Cadeia que representa o código de idioma.
currency: Cadeia
Um valor Cadeia que representa o código de moeda.
print currency name flag: Booleano
Um valor Booleano que indica se um nome de moeda tem de ser adicionado ao texto escrito por extenso.
decimal points: Número inteiro
Um valor Número inteiro que indica o número de casas decimais que o texto escrito por extenso deve ter.
Valores de retorno
Cadeia
O valor de texto resultante.
Notas de utilização
O código de idioma é opcional. Se for definido como uma cadeia vazia, é utilizado o código de idioma para o contexto de execução. O código de idioma predefinido é EN-US. O código de idioma para o contexto de execução está definido num elemento de Pasta ou Ficheiro do formato de Relatórios eletrónicos (ER) que está em execução.
O código de moeda é opcional. Se for definido como uma cadeia vazia, é utilizada a moeda da empresa para o contexto de execução.
Nota
Os argumentos print currency name flag e decimal points são analisados apenas 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 apenas para empresas em que o contexto do país ou da região apoia a declinação de nomes de moeda.
Exemplo 1
NUMERALSTOTEXT (1234.56, "EN-US", "", false, 2) devolve "One Thousand Two Hundred Thirty Four and 56".
Exemplo 2
NUMERALSTOTEXT (120, "PL", "", false, 0) devolve "Sto dwadzieścia".
Exemplo 3
NUMERALSTOTEXT (120.21, "RU", "EUR", true, 2) devolve "Сто двадцать евро 21 евроцент".