Template:Format price/doc

This template displays numbers typically representing prices in a pleasant way, ideally suited for articles. Numbers one thousand or greater are reduced down and rounded to a total of three digits followed by a multiplier text, and smaller numbers receive separators and exactly two digits to represent cents, which does not always happen with the {{formatnum:}} magic word.

Usage

{{Format price|value|digits}}

Where:

• value: the value that will be formatted and displayed (required).
• digits: sets the digit in which a value lower than one thousand must be rounded, defaulting to "2" (cents) if unspecified.

Providing non-numeric parameters, failing to provide any parameter, or providing a negative value parameter, result all in a link to the NaN article. Despite its name, this template only handles the number-formatting, not any unit symbols – consider {{currency}} for that separate feature.

Examples

• Y {{Format price|1.2}} = 1.20
• Y {{Format price|456.789}} = 456.79
• Y {{Format price|456.789|1}} = 456.80
• Y {{Format price|456.789|0}} = 457
• Y {{Format price|456.789|-2}} = 500
• Y ${{Format price|1234}} = $1,234
• Y ${{Format price|12345}} = $12,345
• Y ${{Format price|123456}} = $123,456
• Y ${{Format price|1000000}} = $1 million
• Y ¥{{Format price|98765432109876}} = ¥98.8 trillion
• Y {{Format price|7.86178E+25}} atoms = 78.6 septillion atoms

Wrong

• File:Red x.svgN {{Format price}} = (empty parameter)
• File:Red x.svgN {{Format price||0}} = (empty first parameter)
• File:Red x.svgN {{Format price|-100}} = (negative values are invalid)
• File:Red x.svgN {{Format price|xyz|A}} = (only numeric values are allowed)
• File:Red x.svgN {{Format price|1E+309}} = (overflow)

See also

• {{Inflation}}
• {{Inflation/fn}}
• {{currency}}

No description.

Template parameters

Parameter		Description	Type	Status
value	1	the value that will be formatted and displayed Example 1,000	Number	required
digits	2	sets the digit in which a value lower than one thousand must be rounded, defaulting to "2" (cents) if unspecified	Number	suggested