dollarFormat

Formats a string in U.S. Dollar format. For other currencies, use LSCurrencyFormat or LSEuroCurrencyFormat. The function will return a number as a string, formatted with two decimal places, thousands separator and dollar sign. If the number is negative, the return value is enclosed in parentheses. If number is an empty string, the function returns zero.

dollarFormat(number) → returns string

  1. CFDocs
  2. Functions
  3. Formatting Functions
  4. dollarFormat
  5. CF
  6. Lucee
  7. 0 Issue
  8. Edit
See Also:   LSCurrencyFormat   LSEuroCurrencyFormat   numberFormat

Argument Reference

number numeric
Required

The number to format.

Compatibility

ColdFusion:

DollarFormat Rounding Bug CF-4199995 - Certain inputs do not cause dollarFormat to round up, for example 6.5850 results in $6.58, yet 6.585 results in $6.59. Consider using numberFormat as a workaround. https://tracker.adobe.com/#/view/CF-4199995

Lucee:

This bug mentioned for ACF also existed in Lucee 4.5, but seems to be fixed in Lucee 5. https://luceeserver.atlassian.net/browse/LDEV-574

Links more information about dollarFormat

Examples
Sample code invoking the dollarFormat function

Dollar Format is about $, commas, and 2 decimal places

dollarFormat(1236598.2)

Expected Result: $1,236,598.20

Negative numbers appear with parentheses. May cause issues due to LDEV-3743

dollarFormat(-11.34)

Expected Result: ($11.34)

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub