Template:Format price
Format price error: cannot parse value ""
.svg){kind=link}
| Warning | This template is used on approximately 8,600 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. |
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, all result in an error message. Despite its name, this template only handles the number-formatting, not any unit symbols – consider {{currency}} for that separate feature.
Examples
- Green tick
{{Format price|1.2}}= 1.20 - Green tick
{{Format price|456.789}}= 456.79 - Green tick
{{Format price|456.789|1}}= 456.80 - Green tick
{{Format price|456.789|0}}= 457 - Green tick
{{Format price|456.789|-2}}= 500 - Green tick
$= $1,234{{Format price|1234}} - Green tick
$= $12,345{{Format price|12345}} - Green tick
$= $123,456{{Format price|123456}} - Green tick
$= $1 million{{Format price|1000000}} - Green tick
¥= ¥98.8 trillion{{Format price|98765432109876}} - Green tick
{{Format price|7.86178E+25}}atoms
Wrong
- Red X
{{Format price}}= Format price error: cannot parse value "" (empty parameter) - Red X
{{Format price||0}}= Format price error: cannot parse value "" (empty first parameter) - Red X
{{Format price|-100}}= Format price error: cannot parse value "-100" (negative values are invalid) - Red X
{{Format price|xyz|A}}= Format price error: cannot parse value "xyz" (only numeric values are allowed) - Red X
{{Format price|1E+309}}= Format price error: cannot parse value "1E+309" (overflow)
See also
- {{Inflation}}
- {{Inflation/fn}}
- {{currency}}
No description.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| value | 1 | the value that will be formatted and displayed
| 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 |