WordNum

Retorna um texto em inglês equivalente a um determinado número.

Sintaxe

WordNum(n [, n2 [, k1 ]])

Parâmetros

Parâmetro

Descrição

n1

O número a ser convertido.

Se alguma das seguintes declarações for verdadeira, a função retornará caracteres * (asterisco) para indicar um erro:

  • n1 não é um número.

  • O valor integral de n1 é negativo.

  • O valor integral de n1 é maior que 922,337,203,685,477,550.

n2 (Opcional)

Um número que indica a opção de formatação. Os números válidos são:

  • 0 (valor padrão): o número é convertido em um texto que representa o número simples.

  • 1: o número é convertido em um texto que representa o valor monetário sem dígitos de fração.

  • 2: o número é convertido em um texto que representa o valor monetário com dígitos de fração.

Se você não incluir um valor de n2, a função usa o valor padrão (0).

k (opcional)

Uma string que representa uma localidade válida. Se você não incluir um valor para k, a função usa a localidade de ambiente.

Consulte Localidades.

A partir desta versão, não é possível especificar um identificador de localidade diferente do idioma inglês para essa função.

Exemplos

As expressões a seguir são exemplos de uso da função WordNum.

Expressão

Retorna

WordNum(123.45)

Cento e vinte e três dólares

WordNum(123,45, 1)

Cento e vinte e três dólares

WordNum(1154.67, 2)

Mil, cento e cinquenta e quatro dólares, sessenta e sete centavos.

WordNum(43, 2)

Quarenta e três dólares e zero centavos

WordNum(Amount[0], 2)

Esse exemplo usa a primeira ocorrência de Amount como o número de conversão.