Compartilhar via


WorksheetFunction.USDollar method (Excel) (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 utilizando o formato de moeda, com os decimais arredondados para o local especificado. O formato utilizado é $#,##0.00_);($#,##0.00).

A principal diferença entre formatar uma célula que contém um número com o comando Formatar Células e formatar um número diretamente com o método Dólar é que o Dólar converte o resultado em texto. Um número formatado com o comando Format Cells não deixa de ser um número. Pode continuar a utilizar números formatados com Dólar em fórmulas, uma vez que o Excel converte números introduzidos como valores de texto em números quando 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.