# DOLLAR

The function described in this Help topic converts a number to text format and applies a currency symbol. The name of the function (and the symbol that it applies) depends upon your language settings.

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

Syntax

DOLLAR(number,decimals)

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

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

Remark

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

Example

The example may be easier to understand if you copy it to a blank worksheet.

1. Create a blank workbook or worksheet.
2. Select the example in the Help topic.

Note   Do not select the row or column headers.

Selecting an example from Help
1. Press CTRL+C.
2. In the worksheet, select cell A1, and press CTRL+V.
3. To switch between viewing the results and viewing the formulas that return the results, press CTRL+` (grave accent), or on the Formulas tab, in the Formula Auditing group, click the Show Formulas button.
A
Data
1234.567
-1234.567
-0.123
99.888
Formula Description (Result)
=DOLLAR(A2, 2) Displays the first number in a currency format, 2 digits to the right of the decimal point (\$1,234.57)
=DOLLAR(A2, -2) Displays the first number in a currency format, 2 digits to the left of the decimal point (\$1,200)
=DOLLAR(A3, -2) Displays the second number in a currency format, 2 digits to the left of the decimal point ((\$1,200))
=DOLLAR(A4, 4) Displays the third number in a currency format, 4 digits to the right of the decimal point((\$0.1230))
=DOLLAR(A5) Displays the fourth number in a currency format, 2 digit to the left of the decimal point (\$99.89)

Applies to:
Excel 2003