Template:Percentage

Template documentationviewedithistorypurge

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 <syntaxhighlight lang="wikitext" inline style="display: none;" />|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 <syntaxhighlight lang="wikitext" inline style="display: none;" />|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

<templatedata> { "params": { "1": { "label": "Numerator", "description": "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.", "type": "number", "required": true }, "2": { "label": "Denominator", "description": "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.", "type": "number", "suggested": true, "default": "100" }, "3": { "label": "Decimals", "description": "Number of decimals to round to (zero or greater); if pad is not Yes, 0-digits will be cropped from the end.", "type": "number", "default": "0" }, "pad": { "label": "Pad / actual number of digits", "description": "If yes, use all digits given in Decimals. If a number, pad to that number of decimals.", "type": "string" }, "sigfig": { "label": "Significant figures", "description": "If set to a positive integer, the precision of the returned number will be adjusted to match the requested number of significant figures.", "type": "number" }, "%": { "description": "Replacement for % symbol", "example": " percent", "type": "string", "label": "% replacement" } }, "description": "Calculates and displays a percentage value." } </templatedata>

See also

• {{Number and percent}}
• {{Winning percentage}}
• {{Round}}
• {{Significant figures}}
• {{Fractions and ratios}}

The above documentation is transcluded from Template:Percentage/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.