WorksheetFunction.USDollar method (Excel)

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.

Syntax

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

Remarks

The USDollar method converts a number to text by 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.

Example

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)

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.