ទំព័រគំរូ:Round/doc
 | This is a documentation subpage for ទំព័រគំរូ:Round. It may contain usage information, categories and other content that is not part of the original ទំព័រគំរូ page. |
 | This template is used on approximately ២៦៤០០០ pages, or roughly 738% 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: |
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−4.
Examples:
{{Round|2.0004|3}}gives ២�000- whereas
{{#expr:2.0004 round 3}}gives 2
- whereas
{{Round|0.000020004|7}}gives ២�00×10−៥{{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)
- whereas
{{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, should 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 109 or less than or equal to −109
- {{Round/e−}} — for scientific notation for numbers greater than −10−4 and less than 10−4 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 × 1034.
TemplateData
[កែប្រែ]This is the TemplateData documentation for the template used by the new VisualEditor.
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.
| 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
[កែប្រែ]See also
[កែប្រែ]- {{rndfrac}}
- {{rndnear}}
- {{rndgaps}}
- {{rndcalc}}
- {{significant figures}}
- Template:Roundup
- Template:Rounddown