Skip to content
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
.gitreview
FormatNum.hooks.php
FormatNum.i18n.magic.php
FormatNum.i18n.php
FormatNum.php
LICENSE
README
composer.json

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]
You can’t perform that action at this time.