Template:Percentage

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 14,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Shortcuts

{{pct}}
{{percent}}

This template uses Lua:

Module:Percentage (sandbox)

Usage

{{percentage|numerator|denominator|decimals to round to (zero or greater)}}

Limitations

Figures smaller than 0.0001% are shown in scientific notation.

Examples

<syntaxhighlight lang="wikitext" inline>33%</syntaxhighlight> yields 33%
<syntaxhighlight lang="wikitext" inline>33.33%</syntaxhighlight> yields 33.33%

Negative values can be used:

<syntaxhighlight lang="wikitext" inline>-33%</syntaxhighlight> yields -33%

Normal operation is to cut off all decimal zeroes from right in rounding:

<syntaxhighlight lang="wikitext" inline>20%</syntaxhighlight> yields 20%
<syntaxhighlight lang="wikitext" inline>11.11%</syntaxhighlight> yields 11.11%

Add |pad=yes to always get as many decimals as specified, padding with zeroes where needed:

<syntaxhighlight lang="wikitext" inline>20.00%</syntaxhighlight> yields 20.00%
<syntaxhighlight lang="wikitext" inline>11.1100%</syntaxhighlight> yields 11.1100%

Third parameter can also be given through |pad=N:

<syntaxhighlight lang="wikitext" inline>11.1000%</syntaxhighlight> is same as <syntaxhighlight lang="wikitext" inline>11.1000%</syntaxhighlight> and yields 11.1000%

Default denominator is 100:

<syntaxhighlight lang="wikitext" inline>20%</syntaxhighlight> yields 20%

Default precision is zero:

<syntaxhighlight lang="wikitext" inline>33%</syntaxhighlight> yields 33%

Override the percent symbol

<syntaxhighlight lang="wikitext" inline>33 percent</syntaxhighlight> yields 33 percent

Use a prescribed number of significant figures

<syntaxhighlight lang="wikitext" inline>0.0250%</syntaxhighlight> yields 0.0250%

Use a prescribed number of significant figures with small percentages

<syntaxhighlight lang="wikitext" inline>00%</syntaxhighlight> yields 00%

Use a prescribed number of significant figures with small percentages without scientific notation

<syntaxhighlight lang="wikitext" inline>00%</syntaxhighlight> yields 00%

Use a prescribed number of significant figures with large percentages

<syntaxhighlight lang="wikitext" inline>2.00×10⁹%</syntaxhighlight> yields 2.00×10⁹%

Use a prescribed number of significant figures with large percentages without scientific notation

<syntaxhighlight lang="wikitext" inline>2000000000%</syntaxhighlight> yields 2000000000%

Dividing by zero will result in "nan" (undefined)

<syntaxhighlight lang="wikitext" inline>nan%</syntaxhighlight> yields nan%

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Percentage in articles based on its TemplateData.

TemplateData for Percentage

Calculates and displays a percentage value.

Template parameters
Parameter		Description	Type	Status
Numerator	`1`	The Numerator of the calculated value. The percentage will be calculated as Numerator divided by Denominator. Use of comma as a thousands separator is optional.	Number	required
Denominator	`2`	The Denominator of the calculated value. The percentage will be calculated as Numerator divided by Denominator. Use of comma as a thousands separator is optional. Can be left out, in which case 100 will be used as the Denominator, and the Numerator will be the direct percentage used. Default 100	Number	suggested
Decimals	`3`	Number of decimals to round to (zero or greater); if pad is not Yes, 0-digits will be cropped from the end. Default 0	Number	optional
Pad / actual number of digits	`pad`	If yes, use all digits given in Decimals. If a number, pad to that number of decimals.	String	optional
Significant figures	`sigfig`	If set to a positive integer, the precision of the returned number will be adjusted to match the requested number of significant figures.	Number	optional
% replacement	`%`	Replacement for % symbol Example  percent	String	optional

Usage

Limitations

Examples

TemplateData

See also