Template:Round/doc
It may contain usage information, categories and other content that is not part of the original template page.
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.
Usage
[edit ]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×ばつ1013
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×ばつ109, or less than 1×ばつ10−4.
Examples
[edit ]{{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×ばつ109{{Round|1542689271|2}}
→ 1.54268927100×ばつ109{{Round|7e9|-9}}
→ 7×ばつ109{{Round|-123|1}}
→ −123.0{{Round|-1200007|-2}}
→ −1,200,000{{Round|-1234567899|-7}}
→ −1.23×ばつ109
As with #expr, the total number of significant digits is not more than 14:
{{Round|1234567890.123456789|10}}
→ 1.2345678901235×ばつ109{{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
[edit ]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.
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
[edit ]See also
[edit ]- {{Rounded calculation }}
- {{Significant figures }}
- {{Roundup }}
- {{Rounddown }}