Extension:FormatNum

MediaWiki extensions manualManual:Extensions

FormatNum Release status:Extension status stable
ImplementationTemplate:Extension#type	Parser function
DescriptionTemplate:Extension#description	Passes number formatting instruction to PHP function number_format
Author(s)Template:Extension#username	Daniel Schuba (DaSchtalk)
Latest versionTemplate:Extension#version	0.6.2 (2014-11-07)
LicenseTemplate:Extension#license	GNU General Public License 2.0 or later
Download	GitHub: project page git repository URL [help] commit history Note: No localisation updates are provided by translatewiki.nettranslatewiki.net. README
Hooks usedTemplate:Extension#hook ParserFirstCallInitManual:Hooks/ParserFirstCallInit LanguageGetMagicManual:Hooks/LanguageGetMagic
Translate the FormatNum extension if it is available at translatewiki.net
Check usage and version matrix.

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  
• t – will be  

Repository

• View repository on github.com
• Issue tracker

Download

• Releases

Download using Git

git clone https://github.com/DaSchTour/FormatNum.git

Installation

Download the files from GitHub. Put them in /extensions/FormatNum and add the following to your LocalSettings.php

require_once( "$IP/extensions/FormatNum/FormatNum.php" );

Use Example

On Wikipedia formatting of numbers is done with complex templates like this. With the #formatnum parser this would be a lot easier.

See also

• Extension:NumberFormat
• Bugzilla:40422 - review and deployment request

Links

• description of number_format at php.net