This documentation is archived and is not being maintained.

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.

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: