mediawiki/format-num

Extension FormatNum makes it easier to format numbers in the style you want, independent of language settings. For input 'english' format is used with point as decimal separator.

v0.6.2 2014-11-07 23:34 UTC

README

Extension '''FormatNum''' makes it easier to format numbers in the style you want, independent of language settings. For input "english" format is used with point as decimal separator.

== Usage ==
* {{#formatnum:''number''|''number of decimals''|''decimal separator''|''thousand separator''|''old thousand separator''}}
* {{#formatnum:''number''|decs=''number of decimals''|dsep=''decimal separator''|tsep=''thousand separator''|otsep=''old thousand separator''|format=''DIN or ISO''|mint=''minimal number to separate thousands''}}

* otsep: thousands separator in the number given, that will be removed. For example when having a number like 123.456.789,123 and setting otsep=. will remove all points from the number before converting.
* mint: the minimal number given to separate thousands. For example when setting to 4 the number 1234 will remain as is and 12345 will be separated to 12 345.

== Examples ==
:{{#formatnum: 2300.123|2|,|_}}
:result: 2 300,12

:{{#formatnum: 2300.123|2|.|,}}
:result: 2,300.12

:{{#formatnum: 2300.123|2}}
:result: 2,300.12

:{{#formatnum: 2300.123|2|,|t}}
:result: 2 300,12

As ''thousand separator'' the following parameters can be also used
* n – will be &nbsp&#59;
* t – will be &thinsp&#59;

== Installation ==
Download the files from github. Put them in /extensions/FormatNum and add the following to your [[LocalSettings.php]]
<syntaxhighlight lang=php>require_once( "$IP/extensions/FormatNum/FormatNum.php" );</syntaxhighlight>

== Use Example ==
On Wikipedia formatting of numbers is done with complex templates like [[🇩🇪Vorlage:FormatZahl|this]]. With the #formatnum parser this would be a lot easier.

== See also ==
* [[Extension:NumberFormat]]
* [[Bugzilla:40422]] - review and deployment request

== Links ==
* [http://www.php.net/manual/en/function.number-format.php description of number_format at php.net]