قالب:Format price/doc
هذه صفحة توثيق فرعية لـ قالب:Format price. تتضمن معلومات الاستعمال، التصنيفات وأي محتوى آخر ليس من محتويات الأصل لصفحة القالب. |
This template is used on many pages, so changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Please consider discussing changes on the talk page قبل تنفيذهم. |
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
{{Format price|1.2}}
= 1٫20{{Format price|456.789}}
= 456٫79{{Format price|456.789|1}}
= 456٫80{{Format price|456.789|0}}
= 457{{Format price|456.789|-2}}
= 500$
= $1٬234{{Format price|1234}}
$
= $12٬345{{Format price|12345}}
$
= $123٬456{{Format price|123456}}
$
= $1 million{{Format price|1000000}}
¥
= ¥98.8 trillion{{Format price|98765432109876}}
= 78.6 septillion atoms{{Format price|7.86178E+25}}
atoms
Wrong
{{Format price}}
= Format price error: cannot parse value "" (empty parameter){{Format price||0}}
= Format price error: cannot parse value "" (empty first parameter){{Format price|-100}}
= Format price error: cannot parse value "-100" (negative values are invalid){{Format price|xyz|A}}
= Format price error: cannot parse value "xyz" (only numeric values are allowed){{Format price|1E+309}}
= Format price error: cannot parse value "1E+309" (overflow)
See also
- {{Inflation}}
- {{Inflation/fn}}
- {{currency}}
لا وصف.
وسيط | وصف | نوع | حالة | |
---|---|---|---|---|
value | 1 | the value that will be formatted and displayed
| رقم | مطلوب |
digits | 2 | sets the digit in which a value lower than one thousand must be rounded, defaulting to "2" (cents) if unspecified | رقم | مقترح |