Template:Val: Difference between revisions

Revision as of 02:35, 12 June 2015

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 24,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:Val

This template is used to easily present values in scientific notation, including uncertainty and/or units, as prescribed by Wikipedia's Manual of Style.

Introduction

Val specializes in numeric values, especially those with scientific notations, uncertainty notations, and those with measurement values with physical units. Because these expressions are covered by the Manual of Style, Val provides the stylized output for you, and keeps them from wrapping across lines.

Express a numeral:

{{val|123456.78901}} → value, formatted with gaps: {{#iferror:123456.78901|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey123456.78901Template:Val/angle, or with |fmt=commas → {{#iferror:123456.78901|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey123,456.78901Template:Val/angle
{{val|number|number}} → value ± uncertainty, like {{#iferror:123478|Template:FormattingError|{{#iferror:56|Template:FormattingError|Template:Val/sortkey123,478Template:Val/angle Template:Val/±
{{val|number|(number)}} → value(uncertainty), like {{#iferror:12345|Template:FormattingError|{{#iferror:56|Template:FormattingError|Template:Val/sortkey12,345(56)Template:Val/angle
{{val|number|number|number}} →value ^+uncertainty
_{−uncertainty} like {{#iferror:1234|Template:FormattingError|{{#iferror:56|Template:FormattingError|Template:Val/sortkey1234Template:Val/angle Template:Val/+-

Express a measurement value: {{val|4|ul=m2}} → {{#iferror:4|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey4Template:Val/angle. The m2 is a "unit code" that Val uses to lookup the link to the unit's article, and the formatting of the unit symbol. Val links the units to the page it has on file for them. See {{Val/list}}.

There are a large number of unit codes that Val understands and keeps "up to code". A unit code is the just abbreviated unit name, but these can get quite involved for a compound or composite unit, with "multipliers" or "dividers". See Module:Val/units.

Some unit-code flexibility is provided by having four parameters to work the unit-code system: whether to link one or not, (see Overlinking), and whether to link the numerator or denominator of a unit ratio separately.

{{val|number|ul=unit code}} → number symbol, such as {{#iferror:9.8|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey9.8Template:Val/angle
{{val|number|u=unit code}} → number symbol, such as {{#iferror:9.8|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey9.8Template:Val/angle
{{val|number|u=unit code|upl=unit code}} → number symbol/symbol, such as {{#iferror:9.8|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey9.8Template:Val/angle

Template:Val/units/Template:Val/units

{{val|number|ul=unit code|up=unit code}} → number symbol/symbol, such as {{#iferror:9.8|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey9.8Template:Val/angle Template:Val/units/:Template:Val/units

To bypass the unit code system, if |u= does not recognize your unit code, it will accept any wikitext and render it as usual.

{{val|5.4|u=[[kg]]⋅[[meter|m]]/s2}} → {{#iferror:5.4|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey5.4Template:Val/angle
{{val|7.6|u=[[metre per second squared|m/s2]]}} → {{#iferror:7.6|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey7.6Template:Val/angle

See Module:Val/units for how to add units to the unit code system.

Sometimes a number and unit code is not enough. A prefix or suffix are also available, |p= and |s=.

{{val|7600|p=>|s=<|u=C⋅Ga}} → {{#iferror:7600|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey>7600Template:Val/angle
{{val|7600|p=|s=|u=C}} → {{#iferror:7600|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey^{7600Template:Val/angle}

See {{val/testcases}} to learn the val parameters by an example. It is comprehensive, and there are over 100 examples.

Arguments

Val takes three unnamed parameters. The first is always the numeric value. When the second and third are numbers they become the various uncertainty notations, but the second unnamed parameter can also serve to grammatically join the first and third numbers.

Val clears surrounding spaces in its unnamed parameters.

1st or `\|1=`	A number in decimal point notation or in e notation. The main basis of the Val expression. `{{val\|1234567.1234567}}` → {{#iferror:1234567.1234567\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234567.1234567Template:Val/angle `{{val\|.1234}}` → {{#iferror:0.1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey0.1234Template:Val/angle (adds the zero) `{{val\|+1234}}` → {{#iferror:1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey+1234Template:Val/angle (displays the plus) `{{val\|-1234}}` → {{#iferror:-1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey−1234Template:Val/angle (replaces the hyphen-minus with a minus sign) `{{val\|12e34}}` → {{#iferror:1.2E+35\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey12e34Template:Val/angle (E notation)
`\|fmt=`	By default, numbers are formatted with gaps separating groups of three digits in both integer and fractional part. However, by default, four-digit integers are not formatted; use `\|fmt=gaps` to force gaps. Use `\|fmt=commas` to delimit the integer part of the number with commas. Use `\|fmt=none` for no formatting (no gaps or commas). `{{val\|1234567.1234567}}` → {{#iferror:1234567.1234567\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234567.1234567Template:Val/angle `{{val\|1234567.1234567\|fmt=commas}}` → {{#iferror:1234567.1234567\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1,234,567.1234567Template:Val/angle `{{val\|1234}}` → {{#iferror:1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234Template:Val/angle `{{val\|1234\|fmt=gaps}}` → {{#iferror:1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234Template:Val/angle `{{val\|1234.5}}` → {{#iferror:1234.5\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234.5Template:Val/angle `{{val\|1234.5\|fmt=none}}` → {{#iferror:1234.5\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234.5Template:Val/angle
`\|end=`	Put something at the end of the main number (before anything else that might follow). `{{val\|11\|end=<END>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11<END>Template:Val/angle `{{val\|11\|22\|end=<END>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11<END>Template:Val/angle Template:Val/± `{{val\|1111\|(22)\|end=<END>}}` → {{#iferror:1111\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey1111<END>(22)Template:Val/angle `{{val\|11\|22\|33\|end=<END>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11<END>Template:Val/angle Template:Val/+- `{{val\|11\|ul=m/s\|end=<END>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11<END>Template:Val/angle
2nd or `\|2=`	Uncertainty in either format. `{{val\|11\|22}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/± `{{Val\|11\|(22)}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11(22)Template:Val/angle A conjunction to join two numbers. Useful for ranges, grammatical output, etc. `{{val\|11\|-\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Missing operand for -.\|Template:FormattingError\|Expression error: Unexpected < operator. `{{val\|11\|–\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized punctuation character "–".\|Template:FormattingError\|Expression error: Unrecognized punctuation character "–". `{{val\|11\|,\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized punctuation character ",".\|Template:FormattingError\|Expression error: Unrecognized punctuation character ",". `{{val\|11\|by\|33\|e=9}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized word "by".\|Template:FormattingError\|Expression error: Unrecognized word "by". `{{val\|11\|and\|33\|end=$}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unexpected and operator.\|Template:FormattingError\|Expression error: Unexpected and operator. `{{val\|11\|or\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unexpected or operator.\|Template:FormattingError\|Expression error: Unexpected or operator. `{{val\|11\|to\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized word "to".\|Template:FormattingError\|Expression error: Unrecognized word "to". `{{val\|11\|x\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized word "x".\|Template:FormattingError\|Expression error: Unrecognized word "x". `{{val\|11\|×\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized punctuation character "×".\|Template:FormattingError\|Expression error: Unrecognized punctuation character "×". `{{val\|11\|/\|33\|ul=m/s}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unexpected / operator.\|Template:FormattingError\|Expression error: Unexpected / operator. Note that for dashes or x's, the various kinds all obtain one properly styled output.
3rd or `\|3=`	Asymmetric uncertainty. `{{Val\|11\|22\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/+-
`\|errend=` or `\|+errend=` and `\|-errend=`	Appends something after an uncertainty. `{{val\|11\|22\|errend=<Errend>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/± `{{val\|11\|22\|33\|-errend=<−Errend>\|+errend=<+Errend>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/+-
`\|u=` or `\|ul=`	The unit code. Val adds a space and the unit. `\|ul=` Link the unit. `\|u=` Don't link the unit. Also accepts wiki markup in lieu of a unit code. `{{val\|11\|ul=m}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle
`\|up=` or `\|upl=`	A unit code, but instead of a space Val adds a slash and the unit, a "per" unit (the denominator), to form a ratio. `\|upl=` Link the per unit. `\|up=` Don't link the per unit. The ratio can be of two unit codes, or a prefix and a unit code. Val will add parentheses to disambiguate, if a unit code has a dot or a slash. `{{Val\|11\|ul=J/C\|upl=F/m}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle (Template:Val/units)/(Template:Val/units) `{{Val\|11\|p=$\|upl=acre}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey$11Template:Val/angle/Template:Val/units `{{Val\|11\|ul=km/s\|upl=Mpc}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle (Template:Val/units)/Template:Val/units `{{Val\|11\|ul=kg.m\|upl=s-2}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle (Template:Val/units)/Template:Val/units
`\|p=`	Prefix the entire Val expression. Non-spaced, but accepts markup. `{{Val\|11\|22\|ul=m/s\|p=<Prefix>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey<Prefix>11Template:Val/angle Template:Val/± `{{Val\|11\|22\|ul=m/s\|p=<Prefix> }}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey<Prefix> 11Template:Val/angle Template:Val/±
`\|s=`	Suffix the entire Val expression. Non-spaced, but accepts markup. `{{Val\|11\|22\|ul=m/s\|s=<Suffix>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/± `{{Val\|11\|22\|ul=m/s\|s= <Suffix>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/±
`\|e=`	Exponent. Val alternatively accepts e notation in the first parameter; these are mutually exclusive (see "1st" argument above). `{{Val\|11\|22\|33\|e=11}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/+-×10¹¹ `{{Val\|11e11\|22\|33}}` → {{#iferror:1100000000000\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11e11Template:Val/angle Template:Val/+-
`\|long scale=`	Usually a unit is the short ton and billion means {{#iferror:1\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1Template:Val/angle×10⁹. But there are long versions of these units and others. Use `\|long scale=on` to assign your unit to the long scale instead. The unit code's link will change and it will sort differently in tables. "See Long and short scales".
`\|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.

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.

Val checks for unsupported parameters and gives a relatively subtle warning if found. See tracking category to track any of these improper usages on existing on the wiki. Hold the mouse over "warning" to see details. Here is what warnings look like:

{{val|1.23|exp=6|u=m/s}} → {{#iferror:1.23|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey1.23Template:Val/angle
{{val|1.23|us=kbit/s}} → {{#iferror:1.23|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey1.23Template:Val/angle
{{val|1.23|.05|.04|.03|u=m/s}} → {{#iferror:1.23|Template:FormattingError|{{#iferror:0.05|Template:FormattingError|Template:Val/sortkey1.23Template:Val/angle Template:Val/+-

Format of numbers

{{Val}} produces formatting compliant with Wikipedia's Manual of Style.

The MOS recommends that numbers either be delimited using thin spaces either side of the decimal, or commas to the left and no delimiters to the right. Articles should be consistent with respect to the style of delimiting. The template defaults to the former style, this can be adjusted using |fmt= (see above).

Sorting

The sort key for each sortable unit is visible at Template:Val/list.

Here is a live example showing the minimal markup for a sortable table:

{| class="sortable"
! Val sort test
! In base unit
|-
| {{val|3|ul=  Mm }}
| {{val|3000000|u=m}}
|-
| {{val|4e6|ul= m }}
| {{val|4000000|u=m}}
|-
| {{val|1|ul=  km }}
| {{val|1000|u=m}}
|-
| {{val|5e3|u=  m }}
| {{val|5000|u=m}}
|-
| {{val|2|u=    m }}
| {{val|2|u=m}}
|}

Click to sort ↓
Val sort test	In base unit
Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey3Template:Val/angle	{{#iferror:3000000\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey3000000Template:Val/angle
Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey4e6Template:Val/angle	{{#iferror:4000000\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey4000000Template:Val/angle
Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1Template:Val/angle	{{#iferror:1000\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1000Template:Val/angle
Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey5e3Template:Val/angle	{{#iferror:5000\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey5000Template:Val/angle
Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey2Template:Val/angle	{{#iferror:2\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey2Template:Val/angle

A sort value relates to a Val expression as follows.

The numeric value is a starting point.
If the unit has an SI Prefix, that order of magnitude is applied.
The value of the unit from its own system of units is applied.
If the unit is composite, each subunit is multiplied or divided per their dimension.
The result is passed to {{ntsh}} which applies a normalization formula.
The output of {{ntsh}} is added (behaviorally only, i.e. "hidden") into the table as usual, via the data-sort-value attribute of a table.

More example expressions

Number

{{val|1.23456e-9|+0.00007|-0.00008|ul=m/s}} → {{#iferror:1.23456E-9|Template:FormattingError|{{#iferror:7.0E-5|Template:FormattingError|Template:Val/sortkey1.23456Template:Val/angle Template:Val/+-
{{val|1.23456|+0.00007|-0.00008|ul=m/s|e=-9}} → {{#iferror:1.23456|Template:FormattingError|{{#iferror:7.0E-5|Template:FormattingError|Template:Val/sortkey1.23456Template:Val/angle Template:Val/+-×10⁻⁹

{{val|1.234e7|0.056|ul=psi}} → {{#iferror:12340000|Template:FormattingError|{{#iferror:0.056|Template:FormattingError|Template:Val/sortkey1.234Template:Val/angle Template:Val/±
{{val|1.234|0.056|ul=psi|e=7}} → {{#iferror:1.234|Template:FormattingError|{{#iferror:0.056|Template:FormattingError|Template:Val/sortkey(1.234Template:Val/angle Template:Val/±)×10⁷

{{val|1.234e-2|(5)}} → {{#iferror:0.01234|Template:FormattingError|{{#iferror:5|Template:FormattingError|Template:Val/sortkey1.234(5)Template:Val/angle
{{val|1.234|(5)|e=-2}} → {{#iferror:1.234|Template:FormattingError|{{#iferror:5|Template:FormattingError|Template:Val/sortkey1.234(5)Template:Val/angle×10⁻²

Prefix/suffix

{{val|12.34|p=Δ }} → {{#iferror:12.34|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkeyΔ 12.34Template:Val/angle
{{val|12.34|p=≅|u=%}} → {{#iferror:12.34|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey≅12.34Template:Val/angle
{{val|12.34|0.25|s=%}} → {{#iferror:12.34|Template:FormattingError|{{#iferror:0.25|Template:FormattingError|Template:Val/sortkey12.34Template:Val/angle Template:Val/±

Numerator/denominator

{{val|1.234|e=7|ul=W|up=m2}} → {{#iferror:1.234|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey1.234Template:Val/angle×10⁷ Template:Val/units/:Template:Val/units

Repeating digits

{{val|1.2|end={{overline|34}}|e=7|ul=W|up=m2}} → {{#iferror:1.2|Template:FormattingError|{{#iferror:0|Template:FormattingError|Template:Val/sortkey1.234Template:Val/angle×10⁷ Template:Val/units/:Template:Val/units

Even more examples

See the testcases at {{val/testcases}}.

FAQ and comments

Q. Why should I use Val?

A1. Val formats numbers:

inserts spaces between groups of digits, meeting MoS standards,
formats standard uncertainties in measurements, providing a ± character, correct spacing, and correct alignment,
formats exponents of 10 and scientific notation,
replaces "-" (hyphen) with a "−" (minus sign).

A2. Val preserves spacing:

It makes sure the value does not wrap at the end of a line, so that it can always be read as a single value on one line in the text.
It spaces the various parts of the value where they should be.

A3. Configuring Val gives you your own code for automating the markup for, and a link to, any units in the entire Encyclopedia.

A4. Val helps make Wikipedia more consistent. It adheres to the Wikipedia Manual of Style for numbers. Updates to the MoS can be applied to this template and result in automatic modification on values that use it. All this makes sure all values on all pages have the same look and feel because they will all use the same spacing, font size, positioning, etc, and makes updating and checking by the bots easier because they can recognize a value for what it is.

Q. Why not use <math>?

A. For the same reasons HTML might be preferred over TeX:

Because the font in math tags differs both in face and size from the prose, which can disturb the layout of a page when used inline with the prose.
You cannot cut and paste a bitmap image rendered by the LaTeX.
Images are slower to load and use more bandwidth, which is especially bad for the mobile version of Wikipedia.
<math> does not automatically easily align to the Manual of Style for numbers.

Q. Are there any known issues with Val?: A1: This template is now a new Lua module as of Aug 6, 2015. Technically, there is no good reason not to try Val.; A2. Issues are solved rapidly by an active set of responsive template coders. See the talk page.
Q. How should I use Val?: A1. Val probably already has your unit on its current list. If not, add your own unit there.; A2. To avoid overlinking, switch from |ul= to |u= and from |upl= to |up=.; A3. Any time you have a unit to link or a table to sort, Val already setup with that unit's link and sorting value.; A3. Use Val along with {{Convert}}. See how to add units to Convert.; A4. Where consistent styling of long list articles, with many hundreds or thousands of numbers or units is needed.

TemplateData

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

TemplateData for Val

This template is used to easily present values in scientific notation, including uncertainty and/or units, as prescribed by Wikipedia's Manual of Style.

Template parameters[Edit template data]
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Number	`1`	A number in decimal point notation or in e notation. The main basis of the Val expression. Example -12.12345e9	String	required
Uncertainty	`2`	no description	String	optional
Asymmetric uncertainty -	`3`	no description	String	optional
Format	`fmt`	By default, numbers are formatted with gaps separating groups of three digits in both integer and fractional part. However, by default, four-digit integers are not formatted; use "gaps" (without quotes) to force gaps. Use the value "commas" (without quotes) to delimit the integer part of the number with commas. Use "none" (without quotes) for no formatting (no gaps or commas). Example commas	String	optional
End	`end`	Put something at the end of the main number (before anything else that might follow).	String	optional
Unit	`u`	The unit code. A space and the unit will be added after the number. Example m	String	optional
Unit – wikilinked	`ul`	The unit code that will be wikilinked to a page with information about the unit. A space and this unit will be added after the number. Example m	String	optional
Unit to be prefixed with a slash (/)	`up`	A unit code, but instead of a space, the template adds a slash and the unit, a "per" unit (the denominator), to form a ratio. Example s	String	optional
Unit to be prefixed with a slash (/) – wikilinked	`upl`	A wikilinked unit code, but instead of a space, the template adds a slash and the unit, a "per" unit (the denominator), to form a ratio. Example s	String	optional
Prefix	`p`	Prefix for the entire Val expression. Non-spaced, but accepts markup.	Content	optional
Suffix	`s`	Suffix for the entire Val expression. Non-spaced, but accepts markup.	Content	optional
Exponent	`e`	Val alternatively accepts e notation in the first parameter; these are mutually exclusive (see the Number parameter). Example 9	Number	optional
errend	`errend`	no description	Unknown	optional
4	`4`	no description	Unknown	optional
5	`5`	no description	Unknown	optional

The above documentation is transcluded from Template:Val/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.

@@ Line 193: / Line 193: @@
   | <!-- No up/upl -->
    {{#if:{{{u|}}}
-     |
+     {{#ifexpr:{{#invoke:String|find|source={{{u}}}|target=[%[<]|plain=false}}
-       &nbsp;{{#invoke:String|match
+       |&nbsp;{{{u}}}<!--a sole u has [[mark<up>]], just return it as is
+      |&nbsp;{{#invoke:String|match
          |s = {{val/units|{{{u}}}}}
          |pattern = [^%[{{!}}]+%f[%]]

1st or `\|1=`	A number in decimal point notation or in e notation. The main basis of the Val expression. `{{val\|1234567.1234567}}` → {{#iferror:1234567.1234567\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234567.1234567Template:Val/angle `{{val\|.1234}}` → {{#iferror:0.1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey0.1234Template:Val/angle (adds the zero) `{{val\|+1234}}` → {{#iferror:1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey+1234Template:Val/angle (displays the plus) `{{val\|-1234}}` → {{#iferror:-1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey−1234Template:Val/angle (replaces the hyphen-minus with a minus sign) `{{val\|12e34}}` → {{#iferror:1.2E+35\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey12e34Template:Val/angle (E notation)
`\|fmt=`	By default, numbers are formatted with gaps separating groups of three digits in both integer and fractional part. However, by default, four-digit integers are not formatted; use `\|fmt=gaps` to force gaps. Use `\|fmt=commas` to delimit the integer part of the number with commas. Use `\|fmt=none` for no formatting (no gaps or commas). `{{val\|1234567.1234567}}` → {{#iferror:1234567.1234567\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234567.1234567Template:Val/angle `{{val\|1234567.1234567\|fmt=commas}}` → {{#iferror:1234567.1234567\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1,234,567.1234567Template:Val/angle `{{val\|1234}}` → {{#iferror:1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234Template:Val/angle `{{val\|1234\|fmt=gaps}}` → {{#iferror:1234\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234Template:Val/angle `{{val\|1234.5}}` → {{#iferror:1234.5\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234.5Template:Val/angle `{{val\|1234.5\|fmt=none}}` → {{#iferror:1234.5\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1234.5Template:Val/angle
`\|end=`	Put something at the end of the main number (before anything else that might follow). `{{val\|11\|end=<END>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11<END>Template:Val/angle `{{val\|11\|22\|end=<END>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11<END>Template:Val/angle Template:Val/± `{{val\|1111\|(22)\|end=<END>}}` → {{#iferror:1111\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey1111<END>(22)Template:Val/angle `{{val\|11\|22\|33\|end=<END>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11<END>Template:Val/angle Template:Val/+- `{{val\|11\|ul=m/s\|end=<END>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11<END>Template:Val/angle
2nd or `\|2=`	Uncertainty in either format. `{{val\|11\|22}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/± `{{Val\|11\|(22)}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11(22)Template:Val/angle A conjunction to join two numbers. Useful for ranges, grammatical output, etc. `{{val\|11\|-\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Missing operand for -.\|Template:FormattingError\|Expression error: Unexpected < operator. `{{val\|11\|–\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized punctuation character "–".\|Template:FormattingError\|Expression error: Unrecognized punctuation character "–". `{{val\|11\|,\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized punctuation character ",".\|Template:FormattingError\|Expression error: Unrecognized punctuation character ",". `{{val\|11\|by\|33\|e=9}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized word "by".\|Template:FormattingError\|Expression error: Unrecognized word "by". `{{val\|11\|and\|33\|end=$}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unexpected and operator.\|Template:FormattingError\|Expression error: Unexpected and operator. `{{val\|11\|or\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unexpected or operator.\|Template:FormattingError\|Expression error: Unexpected or operator. `{{val\|11\|to\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized word "to".\|Template:FormattingError\|Expression error: Unrecognized word "to". `{{val\|11\|x\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized word "x".\|Template:FormattingError\|Expression error: Unrecognized word "x". `{{val\|11\|×\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unrecognized punctuation character "×".\|Template:FormattingError\|Expression error: Unrecognized punctuation character "×". `{{val\|11\|/\|33\|ul=m/s}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:Expression error: Unexpected / operator.\|Template:FormattingError\|Expression error: Unexpected / operator. Note that for dashes or x's, the various kinds all obtain one properly styled output.
3rd or `\|3=`	Asymmetric uncertainty. `{{Val\|11\|22\|33}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/+-
`\|errend=` or `\|+errend=` and `\|-errend=`	Appends something after an uncertainty. `{{val\|11\|22\|errend=<Errend>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/± `{{val\|11\|22\|33\|-errend=<−Errend>\|+errend=<+Errend>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/+-
`\|u=` or `\|ul=`	The unit code. Val adds a space and the unit. `\|ul=` Link the unit. `\|u=` Don't link the unit. Also accepts wiki markup in lieu of a unit code. `{{val\|11\|ul=m}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle
`\|up=` or `\|upl=`	A unit code, but instead of a space Val adds a slash and the unit, a "per" unit (the denominator), to form a ratio. `\|upl=` Link the per unit. `\|up=` Don't link the per unit. The ratio can be of two unit codes, or a prefix and a unit code. Val will add parentheses to disambiguate, if a unit code has a dot or a slash. `{{Val\|11\|ul=J/C\|upl=F/m}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle (Template:Val/units)/(Template:Val/units) `{{Val\|11\|p=$\|upl=acre}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey$11Template:Val/angle/Template:Val/units `{{Val\|11\|ul=km/s\|upl=Mpc}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle (Template:Val/units)/Template:Val/units `{{Val\|11\|ul=kg.m\|upl=s-2}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle (Template:Val/units)/Template:Val/units
`\|p=`	Prefix the entire Val expression. Non-spaced, but accepts markup. `{{Val\|11\|22\|ul=m/s\|p=<Prefix>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey<Prefix>11Template:Val/angle Template:Val/± `{{Val\|11\|22\|ul=m/s\|p=<Prefix> }}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey<Prefix> 11Template:Val/angle Template:Val/±
`\|s=`	Suffix the entire Val expression. Non-spaced, but accepts markup. `{{Val\|11\|22\|ul=m/s\|s=<Suffix>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/± `{{Val\|11\|22\|ul=m/s\|s= <Suffix>}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/±
`\|e=`	Exponent. Val alternatively accepts e notation in the first parameter; these are mutually exclusive (see "1st" argument above). `{{Val\|11\|22\|33\|e=11}}` → {{#iferror:11\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11Template:Val/angle Template:Val/+-×10¹¹ `{{Val\|11e11\|22\|33}}` → {{#iferror:1100000000000\|Template:FormattingError\|{{#iferror:22\|Template:FormattingError\|Template:Val/sortkey11e11Template:Val/angle Template:Val/+-
`\|long scale=`	Usually a unit is the short ton and billion means {{#iferror:1\|Template:FormattingError\|{{#iferror:0\|Template:FormattingError\|Template:Val/sortkey1Template:Val/angle×10⁹. But there are long versions of these units and others. Use `\|long scale=on` to assign your unit to the long scale instead. The unit code's link will change and it will sort differently in tables. "See Long and short scales".
`\|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.

Template:Val: Difference between revisions

Revision as of 02:35, 12 June 2015

Contents

Introduction

Arguments

Errors

Format of numbers

Sorting

More example expressions

Number

Uncertainty

Units

Exponents

Prefix/suffix

Numerator/denominator

Repeating digits

Even more examples

FAQ and comments

See also

TemplateData

Navigation menu

Page actions

Page actions

Personal tools

Navigation

Search

Tools

In other languages