Jump to content

Template:Round/doc

From Wikipedia, the free encyclopedia

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
  • {{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×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]
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

[edit]

See also

[edit]