模板:Val

模板页面
文档图示 模板文档[查看] [编辑] [查看历史] [清除缓存]

用法

便于使用科学计数法(包括不确定性)显示数值。

模板参数[编辑模板数据]

此模板首选参数不换行的行内格式。

参数描述类型状态
数值1

无描述

未知可选
不确定性(上界)2

无描述

未知可选
不确定性下界3

无描述

未知可选
不加错误提示分类nocategory

无描述

未知可选
指数e

无描述

未知可选
单位u ul

无描述

未知可选
up upl

无描述

未知可选
值前缀p

无描述

未知可选
主后缀end

无描述

未知可选
不确定性上界后缀+errend

无描述

未知可选
不确定性下界后缀-errend

无描述

未知可选
不确定性后缀errend

无描述

未知可选
值后缀s

无描述

未知可选

Purpose

This template is used to easily present values in scientific notation, including uncertainty and/or units, in accordance with the wikipedia manual of style. It wraps the entire result in a 模板链接:{{nowrap}} block, so that it never gets broken into separate pieces at the end of a line. (See Qiuwen:NBSP for more information on the usage of non-breaking spaces.)

Arguments

There are four ways this template can be used:

  • {{val|number}} - for displaying values without uncertainty/significance.
  • {{val|number|uncertainty}} - for displaying values with uncertainty like so 1234±56.
  • {{val|number|upper uncertainty|lower uncertainty}} - for displaying values with uncertainty like so 1234+56
    −78
    .
  • {{val|number|(significance)}} - for displaying values with significance like so 1234(56).

They all take roughly the same arguments

1 The value (must be a valid number)
2 The (upper limit of) uncertainty (must be a valid number) or significance (must be a valid number in parenthesis)
3 The lower limit of uncertainty (must be a valid negative number)
e The exponent for the power of 10 (optional). This will show up in the result as " × 10e".
Values (arguments 1-3 and e) are run through code copied from 模板链接:{{delimitnum}} for readability, except for argument 2 when it is surrounded by parenthesis. This currently causes an error for large numbers, numbers that require high precision and numbers that have zeros after the decimal point. This last issue is being addressed, the other issues require changes to the Wikipedia software.
u / ul The units for the number (optional, with/without a link to the page about the unit respectively).
up / upl The units per for the units (optional, requires u to be specified, with/without a link to the page about the unit respectively).
Units (specified by u, ul, up and upl) are replaced by a more aesthetically pleasing HTML representation and get a link (ul and upl only, if they are in the list found in 模板链接:{{val/units}} or if they are supported by 模板链接:{{convert}}). You can specify units using just u; a good example is "ul=m/s", which gets translated to "m·s-1", or you can use u and up, as in "u/up"; a good examples if "ul=m|up=s", which gets translated to "m/s".
p A prefix for the value (such as ∆, ⌀, etc.; optional).
s A suffix for the value (such as %, optional).
Prefixes (specified by p) and suffixes (specified by s) are put in front of or behind the value as is: this includes spaces. They are inside the nowrap block and will always be on the same line as the value. The parameters that previously provided this functionality (h for header and f for footer) are deprecated and will be ignored.
end Appends something after the main value. For example, {{val|123.24|end=...}} gives 123.24...
errend Appends something after the uncertainty. For example, {{val|123.23|end=...|2.34|errend=...}} gives 123.23...±2.34...
+errend & -errend Appends something after the positive/negative uncertainties. For example, {{val|123.23|end=...|+2.34|+errend=...|-1.23|-errend=...}} gives 123.23...+2.34...
−1.23...
nocategory If set to any value, errors in the use of this template will not cause the page to be added to the Pages with incorrect formatting templates use category. This is useful for documentation and test pages that do not need to be fixed.

See 模板链接:{{val/test}} for a list of examples of the correct output of 模板链接:{{val}} and the errors it may return when incorrectly used.

Errors

There is strict checking on the validity of arguments; any incorrect use will result in an error, which is displayed using 模板链接:{{FormattingError}}. Pages that contain incorrect use of this template will show up on Category:Pages with incorrect formatting templates use.

Format convention

As mentioned before, 模板链接:{{val}} should produce formatting compliant with the wikipedia manual of style. It currently produces formatting compliant with the U.S. Government Printing Office Style Manual, in rules 12.9e and 12.14, which requires that the decimal separator be a full stop; i.e. “decimal point” (.), requires comma-delimiting to the left of the decimal point for numbers with four or more digits to the left (values of 1000 or more), and also requires space-delimiting to the right of the decimal point for numbers containing five or more digits to the right (e.g., 0.12345 and 5.12345 and 125.12345).

Note that if {{val}} is used on numbers simultaneously comprising four or more digits to the left of the decimal point and five or more digits to the right, the resultant expression will delimited with commas left and spaces (actually non-selectable, non-breaking, narrow gaps) right (see below).

Examples

{{val|1234567890}}  →  1234567890
{{val|1.23456789}}  →  1.23456789
{{val|21563.252564425}}  →  21563.252564425 [1]
Uncertainty/significance
{{val|1.234|0.005}}  →  1.234±0.005
{{val|1.234|+0.005|-0.006}}  →  1.234+0.005
−0.006
{{val|1.234|(5)}}  →  1.234(5)
Exponents/units
{{val|1.234|e=5|u=m}}  →  1.234×105 米
{{val|1.234|e=5|u=m2}}  →  1.234×105 m2
{{val|1.234|e=5|ul=m}}  →  1.234×105 
{{val|1.234|0.056|e=7}}  →  (1.234±0.056)×107
{{val|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}}  →  1.23456+0.00007
−0.00008
×10−9 m/s
{{val|1.234|0.056|e=7|ul=psi}}  →  (1.234±0.056)×107 psi
{{val|123.4|ul=USgal}}  →  123.4 US gal
{{val|12.34|ul=mpgimp}}  →  12.34 mi/imp gal
Prefix/suffix
{{val|p=Δ |12.34|s=%}}  →  Δ 12.34%

参见

  • 模板链接:{{Valid|有效}}:数字有效性检查(对于参数1、2、3,e值和不确定性,以10为底的指数)
  • 模板链接:{{FormattingError}} : 格式错误:用于报告不一致的参数
  • 模板链接:{{Val/delimitnum}}:用于在数字组之间用定界符格式化十进制数
  • 模板链接:{{Su}}:用于格式化指数,或者一个或多个二值不确定度的格式(等宽:当前无法打印为PDF)
  • 模板链接:{{Val/units}}:用于格式化单位名称(参数uup的内容)
  • 模板链接:{{Val/unitswithlink}}:用于使用链接格式化单元名称(参数ulupl的内容)
上述文档内容嵌入自Template:Val/doc编辑 | 历史
编者可以在本模板的沙盒创建 | 镜像和测试样例创建页面进行实验。
请将模板自身所属的分类添加在文档中。本模板的子页面