Template:Percentage/sandbox

This is the template sandbox page for Template:Percentage (diff).
See also the companion subpage for test cases.

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

This template is used on approximately 16,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

{{pctTemplate:Pct}}
{{percentTemplate: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

{{Percentage | 1 | 3 | 0 }} yields 33%
{{Percentage | 1 | 3 | 2 }} yields 33.33%

Negative values can be used:

{{Percentage | -1 | 3 }} yields -33%

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

{{Percentage | 1 | 5 | 2 }} yields 20%
{{Percentage | 1111 | 10000 | 4 }} yields 11.11%

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

{{Percentage | 1 | 5 | 2 | pad=yes }} yields 20.00%
{{Percentage | 1111 | 10000 | 4 | pad=yes }} yields 11.1100%

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

{{Percentage | 111 | 1000 | pad=4 }} is same as {{Percentage | 111 | 1000 | 4 | pad=yes }} and yields 11.1000%

Default denominator is 100:

{{Percentage | 20 }} yields 20%

Default precision is zero:

{{Percentage | 1 | 3 }} yields 33%

Override the percent symbol

{{Percentage | 1 | 3 | % =  percent}} yields 33 percent

Use a prescribed number of significant figures

{{Percentage | 1 | 4000 | sigfig = 3}} yields 0.0250%

Use a prescribed number of significant figures with small percentages

{{Percentage | 1 | 40000000 | sigfig = 3}} yields 00%

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

{{Percentage | 1 | 40000000 | sigfig = 3 | nonscinote = y}} yields 00%

Use a prescribed number of significant figures with large percentages

{{Percentage | 40000000 | 2 | sigfig = 3}} yields 2.00×10⁹%

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

{{Percentage | 40000000 | 2 | sigfig = 3 | nonscinote = y}} yields 2000000000%

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

{{Percentage | 0 | 0 | 0 }} 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[Edit template data]
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