Misplaced Pages

Template:Round/testcases

Article snapshot taken from Wikipedia with creative commons attribution-sharealike license. Give it a read and then ask your questions in the chat. We can research this topic together.
< Template:Round

This is an old revision of this page, as edited by CapitalR (talk | contribs) at 09:57, 17 March 2009 (updating per request). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

Revision as of 09:57, 17 March 2009 by CapitalR (talk | contribs) (updating per request)(diff) ← Previous revision | Latest revision (diff) | Newer revision → (diff) Template documentation[view] [edit] [history] [purge] Shortcut
WarningThis template is used on approximately 264,000 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}} → 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
  • {{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
  • {{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 1×10^9, or less than 1×10^−4.

Template parameters

ParameterDescriptionTypeStatus
number1

The number to be rounded

Numberrequired
decimal places2

The number of decimal places, if negative the number is rounded so the last (parameter 2) digits are zero

Numbersuggested

Maintenance categories

See also

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