Template:Round

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

{{rnd }}

Warning This template is used on approximately 325,000 pages, or roughly 1% of all pages .
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:Math (sandbox)

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}} → 54.38
{{Round|54.376|-1}} → 50
{{Round|68.4273E12|-10}} → 6.843×ばつ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}} → 2.000
- {{expr:2.0004 round 3}} → 2
{{Round|0.000020004|7}} → 000
{{Round|0|8}} → 0.00000000
{{Round|154268|-3}} → 154,000
{{Round|154568|-3}} → 155,000
{{Round|1200004|-1}} → 1,200,000
- whereas {{expr:1200004round-1}} → 1200000, even though {{expr:1300004round-1}} → 1300000 (see m:Help:Format produced by expr)
{{Round|1300004|-1}} → 1,300,000
{{Round|4.1e6|9}} → 4,100,000.000000000
{{Round|4.1e6|10}} → 4,100,000.0000000000
{{Round|1542689271|-7}} → 1.54×ばつ10⁹
{{Round|1542689271|2}} → 1.54268927100×ばつ10⁹
{{Round|7e9|-9}} → 7×ばつ10⁹
{{Round|-123|1}} → −123.0
{{Round|-1200007|-2}} → −1,200,000
{{Round|-1234567899|-7}} → −1.23×ばつ10⁹

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

{{Round|1234567890.123456789|10}} → 1.2345678901235×ばつ10⁹
{{Round|123456789.0123456789|10}} → 123,456,789.01235
{{Round|.0001234567890123456789|20}} → 0.00012345678901235

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

{{Round|1.234567}} → 1
{{Round|1.234567|2}} → 1.23
{{Round|1.234567|2.3}} → 1.2329205947231
{{Round|1.234567|2.7}} → 1.2350673729657

Non-numeric input will result in an error message.

{{Round|invalid}} → Formatting error: invalid input when rounding

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 ×ばつ10^9, or less than ×ばつ10^−4.

Template parameters[Edit template data ]
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	suggested

Maintenance categories

Category:Pages with bad rounding precision (0)

Usage

Examples

TemplateData

Maintenance categories

See also