模板:Order of magnitude/doc

此模板文件被引用於約128,000個頁面。
為了避免造成大規模的影響，所有對此模板文件的編輯應先於沙盒、測試樣例或您的沙盒上測試。
測試後無誤的版本可以一次性地加入此模板文件中，但是修改前請務必於討論頁發起討論。

模板引用數量會自動更新。

此頁面是Template:Order of magnitude的模板文件。
此頁面可能包含了模板的使用說明、分類和其他內容。

使用方法

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.

範例

{{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]
Template:Xpdoc

錯誤用法

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"

技術要點

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.

模板數據

以下是該模板的模板資料，適用於視覺化編輯器等工具。

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.

模板參數
參數		描述	類型	狀態
Number	`1`	The number to find the order of magnitude of	數值	必填