Template:Formatnum/doc
 | This is a documentation subpage for Template:Formatnum. It contains usage information, categories, and other content that is not part of the original template page. |
This template formats a number in the local format (local numerals, local thousands separator, decimal separator and the pattern of separators) of a given language.
The total number of digits before and after the decimal point is limited to 16. In the 16th digit there may be a deviation of 1 or 2 units, as the unit in the last place (ulp) has a maximum of 2.22 units in the 16th digit (see also Help:Calculation#Accuracy).
Parameters
edit| Parameter name | Description | Default value |
|---|---|---|
| 1 | number without thousands separators | empty |
| 2 | language code | value of {{int:Lang}} |
| sep | set to any non-empty value to produce a result without thousands separators | empty |
| prec | number of digits after the decimal point to show | if empty or undefined: 0 |
Examples
Some results depend on the user language, try: ab · ae · af · ak · am · an · ar · as · ast · av · ay · az · ba · bar · bcl · be · be-tarask · bg · bi · bm · bn · bo · br · bs · ca · ce · ceb · ch · chy · cnr · co · cps · cr · cs · cu · cv · cy · da · de · dv · dz · ee · egl · el · en · eo · es · et · ext · fa · fi · fj · ff · fo · fr · frc · frp · frr · frs · fur · fy · ga · gd · gl · gn · got · gsw · gu · gv · ha · haw · he · hi · hil · ho · hr · ht · hu · hy · hyw · hz · id · ie · ig · ii · ik · io · is · it · ja · jut · jv · ka · kg · ki · kj · kk · kl · km · kn · ko · ks · ksh · ku · kv · kw · ky · la · lb · lg · li · lij · lld · lmo · ln · lo · lt · lu · lv · mg · mh · mi · mk · ml · mn · mr · ms · mt · mwl · my · na · nan · nb · nd · nds · nds-nl · ne · nl · nn · nr · nrf · nv · ny · oc · oj · om · or · os · pa · pcd · pdc · pfl · pi · pl · pms · pt · qu · rar · rej · rgn · rif · rm · rn · ro · ru · rue · ruo · rup · ruq · rw · ryu · sa · sah · sat · sc · scn · sco · sd · sdc · se · sg · sh · si · sk · sl · sm · smj · smn · sms · sn · so · sou · sq · sr · ss · st · su · sv · sw · ta · te · tg · th · ti · tk · tl · to · tr · ts · tt · tw · ty · uk · ur · uz · ve · vec · vep · vi · vo · vls · wa · war · wo · wuu · xh · yi · yo · yue · za · zea · zh-hans · zh-hant · zu
{{formatnum|1234567890.123}}→ 1,234,567,890.123{{formatnum|-1234567890.123}}→ −1,234,567,890.123{{formatnum|1234567890.123|en}}→ 1,234,567,890.123{{formatnum|1234567890.123|sep=x}}→ 1234567890.123{{formatnum|1234567890.123|en|sep=x}}→ 1234567890.123{{formatnum|1234567890.123|nl}}→ 1.234.567.890,123{{formatnum|1234567890.123|de}}→ 1.234.567.890,123{{formatnum|1234567890.123|fr}}→ 1 234 567 890,123{{formatnum|1234567890.123|bn}}→ ১,২৩,৪৫,৬৭,৮৯০.১২৩ (Bengali){{formatnum|1234567890.123|ckb}}→ ١٬٢٣٤٬٥٦٧٬٨٩٠٫١٢٣ (Sorani){{formatnum|1234567890.123|hi}}→ १,२३,४५,६७,८९०.१२३ (Hindi){{formatnum|1234567890.123|fa}}→ ۱٬۲۳۴٬۵۶۷٬۸۹۰٫۱۲۳ (Persian){{formatnum|1234567890.123|kn}}→ ೧,೨೩,೪೫,೬೭,೮೯೦.೧೨೩ (Kannada){{formatnum|1234567890.123|pa}}→ 1,23,45,67,890.123 (Punjabi)
{{formatnum|123456789012.12}}→ 123,456,789,012.12{{formatnum|12345678901.12}}→ 12,345,678,901.12{{formatnum|1234567890.12}}→ 1,234,567,890.12{{formatnum|234567890.12}}→ 234,567,890.12{{formatnum|34567890.12}}→ 34,567,890.12{{formatnum|4567890.12}}→ 4,567,890.12{{formatnum|567890.12}}→ 567,890.12{{formatnum|67890.12}}→ 67,890.12{{formatnum|7890.12}}→ 7,890.12{{formatnum|890.12}}→ 890.12{{formatnum|90.12}}→ 90.12{{formatnum|4.12}}→ 4.12{{formatnum|4.1}}→ 4.1{{formatnum|4}}→ 4
{{formatnum|1234567890.12345}}→ 1,234,567,890.1235{{formatnum|1234567890.123456}}→ 1,234,567,890.1235
{{formatnum|1234567890|prec=3}}→ 1,234,567,890.000{{formatnum|1234567890.1|prec=3}}→ 1,234,567,890.100{{formatnum|1234567890.12|prec=3}}→ 1,234,567,890.120{{formatnum|1234567890.123|prec=3}}→ 1,234,567,890.123{{formatnum|1234567890.1234|prec=3}}→ 1,234,567,890.123{{formatnum|1234567890.12345|prec=3}}→ 1,234,567,890.123{{formatnum|1234567890.123456|prec=3}}→ 1,234,567,890.123
{{formatnum|0.000123456|prec=3}}→ 0.000
{{formatnum|9999999999.9999}}→ 9,999,999,999.9999{{formatnum|9999999999.99999}}→ 10,000,000,000{{formatnum|9999999999.999999}}→ 10,000,000,000{{formatnum|9999999999.9999999}}→ 10,000,000,000
{{formatnum|-6.7e-8}}→ −6.7E−8{{formatnum|0}}→ 0{{formatnum|0|bn}}→ ০{{formatnum|6.7e-18}}→ 6.7E−18{{formatnum|6.7e-8}}→ 6.7E−8{{formatnum|6.7e8}}→ 670,000,000{{formatnum|1.234567890123456e17}}→ 1.2345678901235E17{{formatnum|6.7e17}}→ 6.7E17{{formatnum|1.234567890123456e18}}→ 1.2345678901235E18{{formatnum|6.7e18}}→ 6.7E18
{{formatnum|e8}}→ e8 (not a valid number, returns the input){{formatnum}}→
Required
Localization
This template does not have to be localized itself.
See also
- commons:Template:Formatnum
- w:Decimal separator#Examples of use
- Template:Nts - in addition to formatting the number, also an invisible sortkey is prefixed