Template:Order of magnitude/doc

This is a documentation subpage for Template:Order of magnitude.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on 270,000+ pages, or roughly 32% 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.

Usage

This template calculates the (decimal) order of magnitude of numbers within the ranges 10³⁰⁰ to 10⁻³⁰⁰ and −10⁻³⁰⁰ to −10³⁰⁰.

The acceptable input and the output produced are optimised for use in other templates.

The hyphen (not a true minus sign) is used for negative numbers.
No separator is used for thousands.
The template gives 0 for 0. Although, strictly speaking, this is mathematically incorrect it has been designed this way so as to be more useful in other templates. An important example of this is that when used by {{convert}} 0 °C or 0 °F is considered to be on the same order of magnitude as ±1 °C or ±1 °F respectively.

Examples

{{Order of magnitude|123400}} → 5 [1]
{{Order of magnitude|12340}} → 4 [2]
{{Order of magnitude|1234}} → 3 [3]
{{Order of magnitude|123.4}} → 2 [4]
{{Order of magnitude|12.34}} → 1 [5]
{{Order of magnitude|1.234}} → 0 [6]
{{Order of magnitude|.1234}} → -1 [7]
{{Order of magnitude|.01234}} → -2 [8]
{{Order of magnitude|0}} → 0 [9]
{{Order of magnitude}} gives 0 [10]

Incorrect usage

The input must be an unformatted number, or the template will emit errors:

{{Order of magnitude|}} → Expression error: Unexpected = operator
{{Order of magnitude|123,400}} → Expression error: Unrecognised punctuation character ","
{{Order of magnitude|foo}} → Expression error: Unrecognised word "foo"

Technical points

This template calculates the order of magnitude of a number, using the natural logarithm of the absolute value of the number, divided by the log of 10. The amount is adjusted for truncation error in the digital format, and the floor number of the results is used. The magnitude of fractions, such as 0+1/1000 (-3), will also be calculated. The code uses four expansion-depth levels.

Template data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Order of magnitude in articles based on its TemplateData.

TemplateData for Order of magnitude

This template calculates the order of magnitude of numbers within the ranges 10^300 to 10^−300 and −10^−300 to −10^300.

Template parameters
Parameter		Description	Type	Status
Number	`1`	The number to find the order of magnitude of	Number	required