# Template:Rnd

This template is currently being merged with Template:Round.This template is being merged with another template, according to the specific instructions at Wikipedia:Templates for discussion/Holding cell, after which it will be redirected or deleted. The decision to merge this template was made following this discussion initiated on 14 December 2018 at Templates for discussion.Note: Please review this template's instructions at Wikipedia:Templates for discussion/Holding cell before proceeding with any type of merging. |

This template is used on 230,000+ pages.To avoid large-scale disruption and unnecessary server load, any changes to it should first be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can then be added to this page in a single edit. Please 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.

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^{9}, or less than 1×10^{−4}.

**Examples:**

`{{rnd|2.0004|3}}`

gives 2.000- whereas
`{{[[Template:#expr:2.0004 round 3|#expr:2.0004 round 3]]}}`

gives 2

- whereas
`{{rnd|0.000020004|7}}`

gives 2.00×10^{−5}`{{rnd|0|8}}`

gives 0.00000000`{{rnd|154268|-3}}`

gives 154,000`{{rnd|154568|-3}}`

gives 155,000`{{rnd|1200004|-1}}`

→ 1,200,000- whereas
`{{#expr:1200004round-1}}`

→ 1200000, even though`{{#expr:1300004round-1}}`

→ 1300000 (see m:Help:Format produced by expr)

- whereas
`{{rnd|1300004|-1}}`

→ 1,300,000`{{rnd|4.1e6|9}}`

→ 4,100,000.000000000`{{rnd|4.1e6|10}}`

→ 4,100,000.0000000000`{{rnd|1542689271|-7}}`

→ 1.54×10^{9}`{{rnd|1542689271|2}}`

→ 1.54268927100×10^{9}`{{rnd|7e9|-9}}`

→ 7×10^{9}`{{rnd|-123|1}}`

→ −123.0`{{rnd|-1200007|-2}}`

→ −1,200,000`{{rnd|-1234567899|-7}}`

→ −1.23×10^{9}

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

`{{rnd|1234567890.123456789|10}}`

→ 1.2345678901235×10^{9}`{{rnd|123456789.0123456789|10}}`

→ 123,456,789.01235`{{rnd|.0001234567890123456789|20}}`

→ 0.00012345678901235

## Internal details

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

- {{rnd/-}} — for trailing zeros
- {{rnd/e+}} — for scientific notation for numbers greater than or equal to 10
^{9}or less than or equal to −10^{9} - {{rnd/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 `{{rnd}}`

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 `{{rnd|56.44e33|-32}}`

→ 5.64 × 10^{34}.

### TemplateData

**TemplateData for Rnd**

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 |

## See also

The above documentation is transcluded from Template:Rnd/doc. (edit | history) Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages. Please add categories to the /doc subpage. Subpages of this template. |