Método WorksheetFunction.USDollar (Excel)

Converte um número em formato de texto e aplica um símbolo de moeda. O nome do método (e o símbolo que ele aplica) depende das configurações do idioma.

Sintaxe

expressão. USDollar (Arg1, Arg2)

Expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Arg1	Obrigatório	Double	Uma referência a uma célula que contém um número, ou uma fórmula que é avaliada em um número.
Arg2	Obrigatório	Double	O número de dígitos à direita da vírgula decimal. Se Arg2 for negativo, o número será arredondado à esquerda da vírgula decimal. Se você omitir decimais, será considerado 2.

Valor de retorno

String

Comentários

O método USDollar converte um número em texto usando o formato de moeda, com os decimais arredondados para o local especificado. O formato usado é $#,##0.00_);($#,##0.00).

A principal diferença entre formatar uma célula que contém um número com o comando Format Cells e formatar um número diretamente com o método Dollar é que Dollar converte seu resultado em texto. Um número formatado com o comando Format Cells não deixa de ser um número. Você pode continuar a usar números formatados com Dólar em fórmulas, pois o Excel converte números inseridos como valores de texto em números quando ele calcula.

Exemplo

O exemplo a seguir exibe o primeiro número em um formato de moeda, dois dígitos à direita da vírgula decimal (R$1.234,57).

=DOLLAR(A2, 2)

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.