WorksheetFunction.USDollar Method (Excel)

Office 2013 and later
GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Converts a number to text format and applies a currency symbol. The name of the method (and the symbol that it applies) depends upon the language settings.

expression .USDollar(Arg1, Arg2)

expression A variable that represents a WorksheetFunction object.

Parameters

Name

Required/Optional

Data Type

Description

Arg1

Required

Double

A reference to a cell containing a number, or a formula that evaluates to a number.

Arg2

Required

Double

The number of digits to the right of the decimal point. If Arg2 is negative, the number is rounded to the left of the decimal point. If you omit decimals, it is assumed to be 2.

Return Value

String

The USDollar method converts a number to text using currency format, with the decimals rounded to the specified place. The format used is $#,##0.00_);($#,##0.00).

The major difference between formatting a cell that contains a number with the Format Cells command and formatting a number directly with the DOLLAR method is that DOLLAR converts its result to text. A number formatted with the Format Cells command is still a number. You can continue to use numbers formatted with DOLLAR in formulas, because Excel converts numbers entered as text values to numbers when it calculates.

The following example displays the first number in a currency format, two digits to the right of the decimal point ($1,234.57).

=DOLLAR(A2, 2)
Show: