Difference between revisions 4062263 and 5873107 on simplewiki

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->
==Usage==
This template rounds {{{1}}} to {{{2}}}parameter 1 by parameter 2 decimal places (goes the other way for negatives rounding) and includes trailing zeros.    ⏎
::: {{<code>'''rnd'''|54.376|2</code>}} &nbsp; &nbsp; gives {{rnd|54.376|2}}
::: {{<code>'''rnd'''|54.376|-1</code>}} &nbsp; gives {{rnd|54.376|-1}}
::: {{<code>'''rnd'''|68.4273E12|-10</code>}} gives {{rnd|68.4273E12|-10}}
For example, rounding by 1 gives 1 decimal digit, rounding by&nbsp;0 gives integers, or rounding by&nbsp;-2 gives the amount in hundreds. [[Scientific notation]] is usdisplayed for numbers greater than or equal to 1{{e|9}}, or less than 1{{e|−4}}.

Compare:'''Examples:'''
*{{<code>rnd|2.0004|3</code>}} gives {{rnd|2.0004|3}}
**whereas {{<code>#expr:2.0004 round 3</code>}} gives {{#expr:2.0004 round 3}}
*{{<code>rnd|0.000020004|7</code>}} gives {{rnd|0.000020004|7}}
*{{<code>rnd|0|8</code>}} gives {{rnd|0|8}}
*{{<code>rnd|154268|-3</code>}} gives {{rnd|154268|-3}}
*{{xpsoc|rnd|1200004|-1}}
**whereas {{xpsoc|#expr:1200004round-1}}, even though  {{xpsoc|#expr:1300004round-1}} (see [[m:Help:Format produced by expr]]) 
*{{xpsoc|rnd|1300004|-1}}
*{{xpsoc|rnd|4.1e6|9}}
*{{xpsoc|rnd|4.1e6|10}}
*{{xpsoc|rnd|1542689271|-7}}
*{{xpsoc|rnd|1542689271|2}}
*{{xpsoc|rnd|7e9|-9}}
*{{xpsoc|rnd|-123|1}}
*{{xpsoc|rnd|-1200007|-2}}
*{{xpsoc|rnd|-1234567899|-7}}
As with #expr, the total number of significant digits is not more than 14:
*{{xpsoc|rnd|1234567890.123456789|10}}
*{{xpsoc|rnd|123456789.0123456789|10}}
*{{xpsoc|rnd|.0001234567890123456789|20}}

==Internal details==
The tmarkup-based version of Template:rnd uses three subtemplates:
*{{tl|rnd/-}} — for trailing zeros
*{{tl|rnd/e+}} — for scientific notation for numbers greater than or equal to 10<sup>9</sup> or less than or equal to −10<sup>9</sup>
*{{tl|rnd/e−}} — for scientific notation for numbers greater than −10<sup>−4</sup> and less than 10<sup>−4</sup> but not equal to zero

==Related pages==
*{{tl|rndnearThe [[Lua script|Lua]]-based version of <nowiki>{{rnd}</nowiki> 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 <nowiki>{{rnd|56.44e33|-32}}</nowiki>&nbsp;&rarr; 5.64&nbsp;× 10<sup>34</sup>.

==See also==
*{{tl|rndfrac}}
*{{tl|rndnear}}
*{{tl|rndgaps}}

<includeonly><!--
++++ PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, THANK YOU. -->
{{DEFAULTSORT:{{PAGENAME}}}}
[[Category:Mathematical function templates]]

[[ar:Template:Rnd]]
[[bn:টেমপ্লেট:Rnd]]
[[en:Template:Rnd/doc]]
[[id:Templat:Rnd]]
[[os:Шаблон:Rnd]]
[[ja:Template:Rnd]]
[[tpi:Template:Rnd]]
[[pt:Predefinição:Rnd]]
[[sl:Predloga:Rnd]]
[[sr:Шаблон:Rnd]]
[[zh:Template:Rnd]]
</includeonly>