قالب:Format price

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

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}} = (empty parameter)
N {{Format price||0}} = (empty first parameter)
N {{Format price|-100}} = (negative values are invalid)
N {{Format price|xyz|A}} = (only numeric values are allowed)
N {{Format price|1E+309}} = (overflow)

وسيط		وصف	نوع	حالة
value	`1`	the value that will be formatted and displayed مثال 1,000	رقم	مطلوب
digits	`2`	sets the digit in which a value lower than one thousand must be rounded, defaulting to "2" (cents) if unspecified	رقم	مقترح

Usage

Examples

Wrong

See also