Template:Format price/sandbox

Format price error: cannot parse value ""

This is the template sandbox page for Template:Format price (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 9,200 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Preview message: Transclusion count updated automatically (see documentation).

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

N {{Format price}} = Format price error: cannot parse value "" (empty parameter)
N {{Format price||0}} = Format price error: cannot parse value "" (empty first parameter)
N {{Format price|-100}} = Format price error: cannot parse value "-100" (negative values are invalid)
N {{Format price|xyz|A}} = Format price error: cannot parse value "xyz" (only numeric values are allowed)
N {{Format price|1E+309}} = Format price error: cannot parse value "1E+309" (overflow)

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