WorksheetFunction.USDollar(Double, Double) Method

Reference

Definition

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

public:
 System::String ^ USDollar(double Arg1, double Arg2);

public string USDollar (double Arg1, double Arg2);

Public Function USDollar (Arg1 As Double, Arg2 As Double) As String

Parameters

Arg1: Double

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

Arg2: 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.

Returns

String

Remarks

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(Double, Object) method is that Dollar(Double, Object) 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(Double, Object) in formulas, because Excel converts numbers entered as text values to numbers when it calculates.

Applies to