ଛାଞ୍ଚ:Round/doc

Usage

This template rounds parameter 1 by parameter 2 decimal places (goes the other way for negative rounding) and includes trailing zeros.

• {{Round|54.376|2}}     gives ୫୪.୩୮
• {{Round|54.376|-1}}   gives ୫୦
• {{Round|68.4273E12|-10}} gives ୬.୮୪୩×10^୧୩

For example, rounding by 1 gives 1 decimal digit, rounding by 0 gives integers, or rounding by -2 gives the amount in hundreds. Scientific notation is displayed for numbers greater than or equal to 1 × 10^୯, or less than 1 × 10⁻⁴.

Examples:

• {{Round|2.0004|3}} gives ୨�000
  • whereas {{#expr:2.0004 round 3}} gives 2
• {{Round|0.000020004|7}} gives ୦00
• {{Round|0|8}} gives ୦�00000000
• {{Round|154268|-3}} gives ୧,୫୪,୦୦୦
• {{Round|154568|-3}} gives ୧,୫୫,୦୦୦
• {{Round|1200004|-1}} → ୧୨,୦୦,୦୦୦
  • whereas {{#expr:1200004round-1}} → 1200000, even though {{#expr:1300004round-1}} → 1300000 (see m:Help:Format produced by expr)
• {{Round|1300004|-1}} → ୧୩,୦୦,୦୦୦
• {{Round|4.1e6|9}} → ୪୧,୦୦,୦୦୦�000000000
• {{Round|4.1e6|10}} → ୪୧,୦୦,୦୦୦�0000000000
• {{Round|1542689271|-7}} → ୧.୫୪×10^୯
• {{Round|1542689271|2}} → ୧.୫୪୨୬୮୯୨୭୧00×10^୯
• {{Round|7e9|-9}} → ୭×10^୯
• {{Round|-123|1}} → −୧୨୩�0
• {{Round|-1200007|-2}} → −୧୨,୦୦,୦୦୦
• {{Round|-1234567899|-7}} → −୧.୨୩×10^୯

As with #expr, the total number of significant digits is not more than 14:

• {{Round|1234567890.123456789|10}} → ୧.୨୩୪୫୬୭୮୯୦୧୨୩୫×10^୯
• {{Round|123456789.0123456789|10}} → ୧୨,୩୪,୫୬,୭୮୯.୦୧୨୩୫
• {{Round|.0001234567890123456789|20}} → ୦.୦୦୦୧୨୩୪୫୬୭୮୯୦୧୨୩୫

The second parameter, precision, shoulld be an integer. Non-integer may give unexpected result.

• {{Round|1.234567}} → ୧
• {{Round|1.234567|2}} → ୧.୨୩
• {{Round|1.234567|2.3}} → ୧.୨୩୨୯୨୦୫୯୪୭୨୩୧
• {{Round|1.234567|2.7}} → ୧.୨୩୫୦୬୭୩୭୨୯୬୫୭

Internal details

The markup-based version of Template:Round uses three subtemplates:

• {{Round/-}} — for trailing zeros
• {{Round/e+}} — for scientific notation for numbers greater than or equal to 10⁹ or less than or equal to −10⁹
• {{Round/e−}} — for scientific notation for numbers greater than −10⁻⁴ and less than 10⁻⁴ but not equal to zero

The Lua-based version of {{Round}} uses Module:Math and always has an expansion depth of 3. However, the markup-based version has an expansion depth of 9–15, which depends on the size of the numbers (integer results use depth 9, decimals use depth 12), where astronomical numbers can hit expansion depth of 15 levels, for {{Round|56.44e33|-32}} → 5.64 × 10³⁴.

TemplateData

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

TemplateData for Round

Rounds (parameter 1) by (parameter 2) decimal places, and formats. Scientific notation is used for numbers greater than 1×10^9, or less than 1×10^−4.

Template parameters

Parameter		Description	Type	Status
number	1	The number to be rounded	Number	required
decimal places	2	The number of decimal places, if negative the number is rounded so the last (parameter 2) digits are zero	Number	required

Maintenance categories

• Category:Pages with bad rounding precision (୬୫)

See also

• {{rndfrac}}
• {{rndnear}}
• {{rndgaps}}
• {{significant figures}}