From Afropedia.world
 | This template is used on 1,240,000+ pages, or roughly 20643% 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. |
 | See how to copy this template for information on copying this template and modifying it for use on another wiki. |
 | This template uses Lua: |
Template {{convert}} calculates measurements from one unit (you can enter) to another one, and then presents the results. For example:
{{convert|2|km|mi}}→ 2 kilometres (1.2 mi){{convert|7|mi|km}}→ 7 miles (11 km)
The available units are listed below. Multiple formatting and calculation options are listed below.
Unit name or symbol (abbreviation): 1 pound or 1 lb?
By default, the first value shows unit name, the second the symbols (= abbreviation).
Use |abbr=on/off to change this behaviour:
{{convert|1|lb|kg}}→ 1 pound (0.45 kg) (To compare; default: first value shows unit name){{convert|1|lb|kg|abbr=on}}→ 1 lb (0.45 kg){{convert|1|lb|kg|abbr=off}}→ 1 pound (0.45 kilograms)
|abbr=intoggles the default behaviour (|abbr=out):
{{convert|1|lb|kg|abbr=in}}→ 1 lb (0.45 kilograms)
Adjective: a 10-mile distance
Use |adj=on to produce the adjective form. The difference:
{{convert|10|mi|km}} to go→ 10 miles (16 km) to go. (To compare, default)A {{convert|10|mi|km|adj=on}} distance→ A 10-mile (16 km) distance. (Adjective form)
Rounding: 100 ft is 30 m or 30.5 m or 30.48 m?
In detail, it is 100 feet (30,480 mm)*. In practical use, it is common to round the calculated metric number. With that, there are several possibilities.
Default rounding
- By default, the conversion result will be rounded either to precision comparable to that of the input value (the number of digits after the decimal point—or the negative of the number of non-significant zeroes before the point—is increased by one if the conversion is a multiplication by a number between 0.02 and 0.2, remains the same if the factor is between 0.2 and 2, is decreased by 1 if it is between 2 and 20, and so on) or to two significant figures, whichever is more precise. An exception to this is rounding temperatures (see below).
| Examples of rounding | ||
|---|---|---|
| Input | Displays as | Note |
| {{convert|123|ft|m|-1}} | 123 feet (40 m) | |
| {{convert|123|ft|m|0}} | 123 feet (37 m) | |
| {{convert|123|ft|m|1}} | 123 feet (37.5 m) | |
| {{convert|550|ft|m|0}} | 550 feet (168 m) | Approximate value is 167.64 m |
| {{convert|550|ft|m}} | 550 feet (170 m) | Rounds to 170, when approximate value is 167.64 m |
| {{convert|500|ft|m|0}} | 500 feet (152 m) | Approximate value is 152.4 m |
| {{convert|500|ft|m}} | 500 feet (150 m) | Rounds to 150, when approximate value is 152.4 m |
Convert supports four types of rounding:
Round to a given precision: use |precision=
Specify the desired precision with the fourth unnamed parameter (or third unnamed parameter if the "convert to" parameter is omitted; or fifth unnamed parameter if a range is specified; or fourth unnamed parameter again if a range is specified and the "convert to" parameter is omitted; needs to be replaced with a "precision" named parameter). The conversion is rounded off to the nearest power of 1⁄10 this number. For instance, if the result is 8621 and the round number is "-2", the result will be 8600. If the result is "234.0283043" and the round number is "0", the result will be 234.
Round to a given number of significant figures: use |sigfig=
To specify the output number to be with n significant figures use |sigfig=<number>:
- To compare: {{convert|1200|ft|m}} → 1,200 feet (370 m)
- {{convert|1200|ft|m|sigfig=4}} → 1,200 feet (365.8 m)
- {{convert|1200|ft|m|sigfig=3}} → 1,200 feet (366 m)
- {{convert|1200|ft|m|sigfig=2}} → 1,200 feet (370 m)
- {{convert|1200|ft|m|sigfig=1}} → 1,200 feet (400 m)
Setting |sigfig= is meaningless
- {{convert|1200|ft|m|sigfig=0}} → 1,200 feet (370 m)*
Round to a multiple of 5: 15, 20, 25, ...
Using |round=5 rounds the outcome to a multiple of 5.
{{convert|10|m|ft}}→ 10 metres (33 ft){{convert|10|m|ft|round=5}}→ 10 metres (35 ft)
Similar: using |round=25 rounds the outcome to a multiple of 25.
{{convert|10|m|ft}}→ 10 metres (33 ft){{convert|10|m|ft|round=25}}→ 10 metres (25 ft)- To compare:
{{convert|10|m|ft|sigfig=4}}→ 10 metres (32.81 ft)
In a range, one can round each value individually to the default. Use |round=each:
{{convert|10 x 200 x 3000|m|ft}}→ 10 by 200 by 3,000 metres (33 ft × 656 ft × 9,843 ft){{convert|10 x 200 x 3000|m|ft|round=each}}→ 10 by 200 by 3,000 metres (33 ft × 660 ft × 9,800 ft)
Round to a multiple of a given fraction: 2 3⁄16 inch
Specify the desired denominator using |frac=<some positive integer>. (Denominator is the below-the-slash number, for example the 3 in 1⁄3).
{{convert|5.56|cm|in|frac=16}}→ 5.56 centimetres (2+3⁄16 in){{convert|8|cm|in|frac=4}}→ 8 centimetres (3+1⁄4 in)
The fraction is reduced when possible:
{{convert|8|cm|in|frac=100}}→ 8 centimetres (3+3⁄20 in){{convert|8|cm|in}}→ 8 centimetres (3.150 in) (To compare)
Rounding the temperatures °C, °F and K
In temperatures, the conversion will be rounded either to precision comparable to that of the input value or to that which would give three significant figures when expressed in kelvins, whichever is more precise.
{{convert|10|C|F K}}→ 10 °C (50 °F; 283 K)
Note
- For a temperature difference, like to convert "A rise of 20 °C", use
|C-change=20&tc. {{convert|20|C-change|F-change K-change}}→ A rise of 20 °C (36 °F; 20 K)
- To compare: "A temperature of 20 °C" would yield: A temperature of 20 °C (68 °F; 293 K)
Into multiple units: 10 °C (50 °F; 283 K)
Separate the multiple output units by a space:
{{convert|10|C|F K}}→ 10 °C (50 °F; 283 K){{convert|5|km|mi nmi}}→ 5 kilometres (3.1 mi; 2.7 nmi)
Ranges of values
A range: 6 to 17 kg (13 to 37 lb)
Range indicators are entered as the second parameter (between the values). Range separators can be:
| Template:Navbar-collapsible | |||
|---|---|---|---|
| Separator | Convert | Result | Notes |
-
|
{{convert|3|-|6|ft}}
|
3–6 feet (0.91–1.83 m) | Input can be hyphen (-) or en dash (–), output uses en dashes |
-– –(en dash)
|
{{convert|3|–|6|ft}}
|
3–6 feet (0.91–1.83 m) | |
and
|
{{convert|3|and|6|ft}}
|
3 and 6 feet (0.91 and 1.83 m) | |
and&&
|
{{convert|3|&|6|ft}}
|
3 &[convert: unknown unit] | Same as and
|
and(-)
|
{{convert|3|and(-)|6|ft}}
|
3 and 6 feet (0.91–1.83 m) | |abbr=on alters the punctuation
|
and(-)|abbr=on
|
{{convert|3|and(-)|6|ft|abbr=on}}
|
3 and 6 ft (0.91–1.83 m) | |
or
|
{{convert|3|or|6|ft}}
|
3 or 6 feet (0.91 or 1.83 m) | |
to
|
{{convert|3|to|6|ft}}
|
3 to 6 feet (0.91 to 1.83 m) | |
to(-)
|
{{convert|3|to(-)|6|ft}}
|
3 to 6 feet (0.91–1.83 m) | |abbr=on alters the punctuation
|
to(-)|abbr=on
|
{{convert|3|to(-)|6|ft|abbr=on}}
|
3 to 6 ft (0.91–1.83 m) | |
to about
|
{{convert|3|to about|6|ft}}
|
3 to about 6 feet (0.91 to about 1.83 m) | |
+/-
|
{{convert|3|+/-|6|ft}}
|
3 ± 6 feet (0.91 ± 1.83 m) | |
+/-± ±
|
{{convert|3|±|6|ft}}
|
3 ± 6 feet (0.91 ± 1.83 m) | |
+
|
{{convert|3|+|6|ft}}
|
3 + 6 feet (0.91 + 1.83 m) | |
,
|
{{convert|3|,|6|ft}}
|
3, 6 feet (0.91, 1.83 m) | |
, and
|
{{convert|3|, and|6|ft}}
|
3, and 6 feet (0.91, and 1.83 m) | |
, or
|
{{convert|3|, or|6|ft}}
|
3, or 6 feet (0.91, or 1.83 m) | |
by
|
{{convert|3|by|6|ft}}
|
3 by 6 feet (0.91 by 1.83 m) | |
x
|
{{convert|3|x|6|ft}}
|
3 by 6 feet (0.91 m × 1.83 m) | Scientific notation.|abbr=on alters the punctuation
|
× ×
|
{{convert|3|×|6|ft}}
|
3 by 6 feet (0.91 m × 1.83 m) | |
x|abbr=on
|
{{convert|3|x|6|ft|abbr=on}}
|
3 ft × 6 ft (0.91 m × 1.83 m) | |
xx
|
|xx| is deprecated. Use |x| instead | ||
*
|
|*| is deprecated. Use |x| instead | ||
to-
|
|to-| is deprecated. Use |to(-)| instead | ||
&
|
|&| is deprecated. Use |and| instead | ||
abbr=mos
|
|abbr=mos is deprecated. Use |x| or |by| instead | ||
Multiple dimensions: 6 m × 12 m (20 ft × 39 ft)
- Use "by"
{{convert|6|by|12|ft|m}}→ 6 by 12 feet (1.8 by 3.7 m)- Use "×" or ""x""
{{convert|6|x|12|m|ft}}→ 6 by 12 metres (20 ft × 39 ft)
In science, the formal way is to set |x| and |abbr=on (keeping dimensions right, like in area = x km2):
{{convert|6|x|12|m|ft|abbr=on}}→ 6 m × 12 m (20 ft × 39 ft)
About feet, inch in ranges and multiples
While it is possible to enter feet, inch in a simple conversion, this is not possible for ranges:
{{convert|1|ft|3|in|mm}}→ 1 foot 3 inches (380 mm) (to compare){{convert|1|ft|3|in|x|3|ft|5|in|mm}}→ 1 foot 3 inches ([convert: unknown unit])*
Words
Spelling of unit name: UK metre or US meter?
Default spelling of units is en-UK. To show en-US spelling, use |sp=us:
{{convert|1|m|ft}}→ 1 metre (3.3 ft) -- default{{convert|1|m|ft|sp=us}}→ 1 meter (3.3 ft)
Spell out numbers: ten miles
To write a number in words, use |spell=in:
{{convert|10|mi|m|spell=in}}→ 10 miles (16,000 m)*
To spell out both in and out values, use |spell=on:
{{convert|10|mi|m|spell=on}}→ Lua error in Module:Convert at line 402: attempt to call upvalue 'speller' (a string value).
To make first letter a capital, use |spell=In, |spell=On
{{convert|10|mi|m|spell=In}}→ 10 miles (16,000 m)*{{convert|10|mi|m|spell=On}}→ Lua error in Module:Convert at line 402: attempt to call upvalue 'speller' (a string value).
Remember that the spelling of the units (ft, m) is independently set by |abbr=. To the extreme:
{{convert|10|mi|m|spell=on|abbr=off|sp=us}}→ Lua error in Module:Convert at line 402: attempt to call upvalue 'speller' (a string value).
Extra words: 4 planted acres
- Incomplete section
{{convert|4|acre||adj=pre|planted}}→ 4 planted acres (1.6 ha)
Extra adjective words: A 10-foot-long corridor
{{convert|4|ft|m|adj=mid|-long}}→ 10-foot-long (3.0 m)
Plural or singular: 1 inch, 2 inches
The unit symbol is singular always. Depending on the preceding number only, a unit name can be shown plural.
{{convert|1|metre}}→ 1 metre (3 ft 3 in){{convert|2|metre}}→ 2 metres (6 ft 7 in){{convert|2|metre|abbr=on}}→ 2 m (6 ft 7 in)
- Exception
Entering the unit spelled |foot| forces singular output "foot", whatever the number is.
{{convert|100|foot|abbr=off}}→ 100 foot (30 metres)
Grammatical construction: The 18-, 24- and 32-pounder (8, 11 and 15 kg) cannons
This example is from article Fort McHenry:
The American defenders had 18-, 24- and 32-pounder (8, 11 and 15 kg) cannons.
This formatted result is not possible straightforward by using {{convert}}. However, it can be made in three steps.
- Step 1: Enter the input numbers and units in {{convert}} just to get the calculated output:
had {{convert|18 |, |24 |, |32 |lb |kg |0 }} cannons
- → had 18, 24, 32 pounds (8, 11, 15 kg) cannons
- The core conversion should look good now. You can save this (or preview).
- Step 2: We need the resulting text in plain code in the page, not as a {{convert|...}} template.
- For this, add
subst:to the template name(for 'substitute') :had {{Template:Purpleconvert|18 |, |24 |, |32 |lb |kg |0 }} cannons
- As a check: the preview result should show the conversion correct, with the numbers still right.
- Now save this.
- → had 18, 24, 32 pounds (8, 11, 15 kg) cannons
- Step 3: When opening the edit screen again, you'll see that the text is there in code. The template {{convert|...}} itself has disappeared. You can change the text as needed. The edit screen text is:
had 18, 24, 32 pounds (8, 11, 15 kg) cannons
- You can edit this text to add the grammar:
had 18Template:Red,Template:Red24Template:Red32Template:RedpoundTemplate:Red (8, 11Template:Red15 kg) cannons
- After saving your edit, it shows:
- → "had 18-, 24- and 32-pounder (8, 11 and 15 kg) cannons".
Numbers
Using an SI prefix: gigameter (Gm), or micrometer (μm)
Template:Sidebar metric prefixes (small)
Units can have an SI prefix like G before the unit: Gm, and giga before the name: gigameter. These are plain multiplication factors.
To illustrate, these are trivial calculations (from meter to meter), showing the multiplication factor:
- 12 Gm (1.2×1010 m)
- 12 μm (1.2×10−5 m)
The prefix can be added before the SI unit (here: unit m for meter):
{{convert|12|Gm|mi|abbr=on}} → 12 Gm (7,500,000 mi)Mm: 12 Mm (7,500 mi)km: 12 km (39,000 ft)mm: 12 mm (0.47 in)μm: 12 μm (0.012 mm)um: 12 μm (0.012 mm) (letter "u" can be used for "μ" here)
The prefix can be used in the output unit:
{{convert|12000|mi||Mm|abbr=on}} → 12,000 mi (19 Mm){{convert|12|in|μm|abbr=on}} → 12 in (300,000 μm)
As an exception, the non-SI unit "inch" can have the "μ" prefix too)
{{convert|12|μm|μin|abbr=on}} → 12 μm (470 μin)
Input with fractions: 1+1⁄2 inches (38.1 mm)
The number to convert can be written in fractions:
{{convert|1/2|in|mm|1}} → 1⁄2 inch (12.7 mm)
Also the fraction slash (⁄) is accepted:
{{convert|1⁄2|in|mm|1}} → 1⁄2 inch (12.7 mm)
With integers, use a + sign
{{convert|2+1⁄2|in|mm|1}} → 2+1⁄2 inches (63.5 mm)
When negative, use a hyphen - and repeat it:
{{convert|-2-1⁄2|in|mm|1}} → −2+1⁄2 inches (−63.5 mm)
{{convert|2-1⁄2|in|mm|1}} → 2–1⁄2 inch (50.8–12.7 mm) Note: this is read as a range
{{convert|-2+1⁄2|in|mm|1}} → [convert: invalid number] Template:Nay Should be a number, not an expression (do not require a calculation)
Engineering notation: 7 × 106 m
Engineering number notations like 7E6 (for 7 × 106) are to be entered as a prefix en to the unit:
{{convert|7|e6m}} → 7 million metres (23,000,000 ft)
The same is possible for the output unit:
{{convert|23,000,000|ft|e6m}} → 23,000,000 feet (7.0×106 m)
Any standard unit (not a combination, multiple, or built-in) can have a prefix:
e3 (thousand), e6 (million), e9 (billion), e12 (trillion), e15 (quadrillion).
Thousands separator: 1,000 mi and 1000 mi
In input, a comma for thousands separator is accepted. A gap (space) is not. In output, by default, the thousand separator is the comma:
{{convert|1,234,567|m|ft}} → 1,234,567 metres (4,050,417 ft){{convert|1,234,567|m|ft}} → 1,234,567 metres (4,050,417 ft){{convert|1 234 567|m|ft}} → [convert: invalid number] Template:Nay
Set |comma=off to remove the separator:
{{convert|1234567|m|ft|comma=off}} → 1,234,567 metres (4,050,417 ft)*
Use |comma=gaps to set digit grouping by gap (<space>) in larger numbers (thousands separator):
{{convert|1234567|m|ft}} → 1,234,567 metres (4,050,417 ft) (To compare, default){{convert|1234567|m|ft|comma=gaps}} → 1234567 metres (4050417 ft)
Setting |comma=5 or |comma=gaps5 will only add the separator when the number of digits is 5 or more:
{{convert|1234|m|ft}} → 1,234 metres (4,049 ft) (To compare, default){{convert|1234|m|ft|comma=5}} → 1234 metres (4049 ft){{convert|1234567|m|ft|comma=5}} → 1,234,567 metres (4,050,417 ft){{convert|1234|m|ft|comma=gaps5}} → 1,234 metres (4,049 ft)*{{convert|1234567|m|ft|comma=gaps5}} → 1,234,567 metres (4,050,417 ft)*
Output with horizontal fraction bar in: 1/2 inch
Using a double slash (//) returns a horizontal bar fraction:
{{convert|1//2|in|mm|1}} → 1/2 inch (12.7 mm){{convert|2+1//2|in|mm|1}} → 2+1/2 inches (63.5 mm)
Output manipulation
Brackets and separators: 10 m [33 ft]
Punctuation that distinguishes the two measurements is set by |disp=.
Options are: b (the default), sqbr, comma, or, br, x|...:
{{convert|10|m|ft}} → 10 metres (33 ft) -- ( ) brackets are the default{{convert|10|m|ft|disp=sqbr}} → 10 metres [33 ft]{{convert|10|m|ft|disp=comma}} → 10 metres, 33 ft{{convert|10|m|ft|disp=or}} → 10 metres or 33 feet
Setting |disp=br will force a new line (<br>)
{{convert|10|m|ft|disp=br}} → 10 metres
33 feet
Setting |disp=x|... allows any text as separator:
{{convert|10|m|ft|disp=x|_MyText_}} → 10 metres_MyText_33 ft -- (To display spaces, use )
Flipping (reordering) the two measurements: 1,609.3 metres (1 mile)
Setting |order=flip will flip (swap) the two measurements:
{{convert|1|mi|m}} → 1 mile (1,609.3 metres) (To compare, default){{convert|1|mi|m|order=flip}} → 1,609.3 metres (1 mile)
When converting to multiple units, the effect is:
{{convert|10|km|mi nmi|order=flip}} → 6.2137 miles; 5.3996 nautical miles (10 kilometres){{convert|10|km|nmi mi|order=flip}} → 5.3996 nautical miles; 6.2137 miles (10 kilometres)
Displaying parts of the result: 2 (1.5)
It is possible to display only parts of the conversion result:
Convert
Output
Description
{{convert|2|cuyd|m3}}2 cubic yards (1.5 m3)
Default, to compare
{{convert|2|cuyd|m3|abbr=values}}
2 (1.5)
Input and output numbers
{{convert|2|cuyd|m3|disp=unit}}cubic yards
Input unit
{{convert|2|cuyd|m3|disp=unit|adj=on}}cubic-yard
Input unit, adjective (hyphenated)
{{convert|2|cuyd|cuyd|0|disp=out|abbr=off}}2 cubic yards
Input (workaround)
{{convert|2|cuyd|m3|abbr=~}}2 cubic yards [cu yd] (1.5 m3)
Input: both name and symbol
{{convert|2|cuyd|m3|disp=unit2}}m3
Output unit (symbol)
{{convert|2|cuyd|m3|disp=unit2|abbr=off}}cubic metres
Output unit (name)
{{convert|2|cuyd|m3|disp=number}}1.5
Output value
{{convert|2|cuyd|m3|disp=out}}1.5 m3
Output value and unit
{{convert|2|cuyd|m3|disp=out|abbr=off}}1.5 cubic metres
Output value and unit
Display input name and symbol: 2 kilopascals [kPa]
Setting |abbr=~ returns both name and symbol of the first (input) unit:
{{convert|2|kPa|psi|abbr=~}} → 2 kilopascals [kPa] (0.29 psi)A {{convert|2|kPa|psi|abbr=~|adj=on}} pressure → A 2-kilopascal [kPa] (0.29 psi) pressure
Table options
For the wikitable structure, there are two options: split over columns and make the table sortable.
Show numbers only in columns in a table
Using {convert} in a table cell, with |disp=table splits the result over two columns:
{{convert|10|m|ft|disp=table}} → style="text-align:right;"|10
|style="text-align:right;"|33
|disp=tablecen does the same, and also centers the text:
{{convert|20|m|ft|disp=tablecen}} → style="text-align:center;"|20
|style="text-align:center;"|66
The units are added as a column header:
m
ft
disp=table
10
33
disp=tablecen
20
66
disp=<other> (default)
30 metres (98 ft)
Sorting
- Use both
|disp=table |sortable=on to produce table columns (pipe symbols), with sortable table column. As of January 2013, only the first (lefthand) column will sort (improvements pending).
- {{convert|10|m|ft|disp=table|sortable=on}} →
style="text-align:right;" data-sort-value="7001100000000000000"|10
|style="text-align:right;" data-sort-value="7001100000000000000"|33
- This shows the hidden numerical sortkey:
align="right"|<span style="display:none">7001100000000000000</span>10 |align="right"|33
m
ft
15+3⁄4
52
15.5
51
16.0
52.5
16
52
Units
- REDIRECT Template:Self-reference
This page is a redirect. The following categories are used to track and monitor this redirect:
- This is a redirect from a template shortcut to a template with a longer name.
- From an alternative spelling: This is a redirect from a title with an alternative spelling of the target name. Pages that link to this redirect may be updated to link directly to the target page if that results in an improvement of the text. Do not "fix" such links if they are not broken. Also, these links should not be replaced with piped links.
- There are many more specific templates such as {{R from alternative hyphenation}}, {{R from alternative punctuation}} and {{R from alternative spacing}}. Also see subcategories of Category:Redirects from modifications for other options (capitals, abbreviations, diacritics, plurals, stylizations, transliteration, ligatures, different parts of speech, etc.)
- From a page move: This is a redirect from a page that has been moved (renamed). This page was kept as a redirect to avoid breaking links, both internal and external, that may have been made to the old page name.
When appropriate, protection levels are automatically sensed, described and categorized.
The table below lists units supported by template {{convert}}. The list is not complete—more complete lists are linked for each dimension. A complete list is at the full list of units.
The unit-code (column 3), is accepted as input by the template. These can be used as the second or third unnamed parameter. Some units have alternative codes; these are shown in brackets e.g. °F (F): either may be entered for Fahrenheit.
Column 7 lists standard combinations of multiple converted outputs. For example, {{convert|55|nmi|km mi}} produces "55 nautical miles (102 km; 63 mi)". Such a combination must be used as the third unnamed parameter.
Abridged list of units supported by {{Convert}}
Explanation
system
unit
unit-
code
symbol or
abbrev.
notes
sample default
conversion
combination
output units
the system(s) to which the unit belongs
units listed by name
unit-code to use in template
symbols shown in output
other notes about the units
sample of the default conversion for the unit
output codes for multiple conversions
LENGTH
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
SI
megametre
Mm
Mm
US spelling: megameter
1.0 Mm (620 mi)
kilometre
km
km
US spelling: kilometer
1.0 km (0.62 mi)
- km mi
metre
m
m
US spelling: meter
1.0 m (3 ft 3 in)
- m ft
- m ftin
centimetre
cm
cm
US spelling: centimeter
1.0 cm (0.39 in)
- cm in
millimetre
mm
mm
US spelling: millimeter
1.0 mm (0.039 in)
- mm in
micrometre
µm (um)
μm
US spelling: micrometer
1.0 μm (3.9×10−5 in)
nanometre
nm
nm
US spelling: nanometer
1.0 nm (3.9×10−8 in)
non-SI metric
ångström
Å
(angstrom)
Å
1.0 Å (3.9×10−9 in)
Imperial
&
US customary
mile
mi
mi
1.0 mi (1.6 km)
- mi km
furlong
furlong
(none)
1.0 furlong (660 ft; 200 m)
chain
chain
(none)
1.0 chain (66 ft; 20 m)
rod
rd
rd
For other names of this unit see the full list.
1.0 rd (17 ft; 5.0 m)
fathom
fathom
(none)
fathom ≡ 6 ft
1.0 fathom (6.0 ft; 1.8 m)
yard
yd
yd
assumes the international definition
1.0 yd (0.91 m)
foot
ft (foot)
ft
long code "foot" outputs foot (and never feet)
1.0 ft (0.30 m)
- ftin (feet and inches)
- ft m (foot m)
inch
in
in
1.0 in (25 mm)
- in cm
- in mm
Other
nautical mile
nmi
nmi
the international standard nautical mile
For other nautical miles see the full list.
1.0 nmi (1.9 km; 1.2 mi)
parsec
pc
pc
1.0 pc (3.3 ly)
light-year
ly
ly
1.0 ly (63,000 AU)
astronomical unit
AU
AU
1.0 AU (150,000,000 km; 93,000,000 mi)
AREA
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
SI
square kilometre
km2
km2
US spelling: square kilometer
1.0 km2 (0.39 sq mi)
- km2 sqmi
square metre
m2
m2
US spelling: square meter
1.0 m2 (11 sq ft)
- m2 sqft
square centimetre
cm2
cm2
US spelling: square centimeter
1.0 cm2 (0.16 sq in)
- cm2 sqin
square millimetre
mm2
mm2
US spelling: square millimeter
1.0 mm2 (0.0016 sq in)
- mm2 sqin
non-SI metric
hectare
ha
ha
1.0 ha (2.5 acres)
Imperial
&
US customary
square mile
sqmi
sq mi
1.0 sq mi (2.6 km2)
- sqmi km2
acre
acre
(none)
1.0 acre (0.40 ha)
square yard
sqyd
sq yd
1.0 sq yd (0.84 m2)
square foot
sqft
(sqfoot)
sq ft
long code "sqfoot" outputs square foot (and never feet)
1.0 sq ft (0.093 m2)
- sqft m2 (sqfoot m2)
square inch
sqin
sq in
1.0 sq in (6.5 cm2)
- sqin cm2
Other
square nautical mile
sqnmi
sq nmi
1.0 sq nmi (3.4 km2; 1.3 sq mi)
dunam
dunam
(none)
For alternative spellings and definitions see the full list
1.0 dunam (0.0010 km2; 0.00039 sq mi)
tsubo
tsubo
(none)
1.0 tsubo (3.3 m2)
VOLUME
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
SI
cubic metre
m3
m3
US spelling: cubic meter
one kilolitre
1.0 m3 (35 cu ft)
cubic centimetre
cm3
cm3
US spelling: cubic centimeter
one millilitre
1.0 cm3 (0.061 cu in)
cc
cc
cubic millimetre
mm3
mm3
US spelling: cubic millimeter
1.0 mm3 (6.1×10−5 cu in)
non-SI metric
kilolitre
kl
kl
US spelling: kiloliter
one cubic metre
1.0 kl (35 cu ft)
kL
kL
litre
l
l
US spelling: liter
one cubic decimetre
Allows triple output units. See: full list.
1.0 l (0.22 imp gal; 0.26 US gal)
- l impgal
- l USgal
- l U.S.gal
- l USdrygal
- l U.S.drygal
L
L
- L impgal
- L impqt
- L USgal
- L U.S.gal
- L USdrygal
- L U.S.drygal
centilitre
cl
cl
US spelling: centiliter
1.0 cl (0.35 imp fl oz; 0.34 US fl oz)
cL
cL
millilitre
ml
ml
US spelling: milliliter
one cubic centimetre
1.0 ml (0.035 imp fl oz; 0.034 US fl oz)
- ml impoz
- ml USoz
- ml U.S.oz
mL
mL
- mL impoz
- mL USoz
- mL U.S.oz
Imperial
&
US customary
cubic yard
cuyd
cu yd
1.0 cu yd (0.76 m3)
cubic foot
cuft (cufoot)
cu ft
long code "cufoot" outputs cubic foot (and never feet)
1.0 cu ft (0.028 m3)
cubic inch
cuin
cu in
1.0 cu in (16 cm3)
Imperial
imperial barrel
impbbl
imp bbl
36 imp gal
1.0 imp bbl (160 l; 36 imp gal; 43 US gal)
imperial bushel
impbsh
imp bsh
8 imp gal
1.0 imp bsh (36 l; 8.0 imp gal; 8.3 US dry gal)
impbu
imp bu
imperial gallon
impgal
imp gal
4.54609 litres by definition, also
4 imp qt or 8 imp pt or 160 imp fl oz
Allows triple output units. See: full list.
1.0 imp gal (4.5 l; 1.2 US gal)
- impgal l
- impgal L
- impgal USgal
- impgal U.S.gal
- impgal USdrygal
- impgal U.S.drygal
imperial quart
impqt
imp qt
1/4 imp gal or 40 imp fl oz
1.0 imp qt (1,100 ml; 38 US fl oz)
imperial pint
imppt
imp pt
1/8 imp gal or 20 imp fl oz
1.0 imp pt (0.57 l)
imperial fluid ounce
impoz (impfloz)
imp fl oz
1/160 imp gal
1.0 imp fl oz (28 ml; 0.96 US fl oz)
- impoz USoz
- impoz U.S.oz
- impoz ml
- impoz mL
US customary
liquid measure
US barrel
USbbl
US bbl
31½ US gal
used for liquids except for oil and beer (see the full list)
1.0 US bbl (120 l; 32 US gal; 26 imp gal)
U.S.bbl
U.S. bbl
barrel
oilbbl
bbl
42 US gal
1.0 bbl (0.16 m3)
US beer barrel
USbeerbbl
(usbeerbbl)
US bbl
1.0 US bbl (120 l; 31 US gal; 26 imp gal)
U.S.beerbbl
(usbeerbbl)
U.S. bbl
US gallon
USgal
US gal
231 cubic inches by definition, also
4 US qt or 8 US pt or 128 US fl oz
Allows triple output units. See: full list.
1.0 US gal (3.8 l; 0.83 imp gal)
- USgal l
- USgal L
- USgal impgal
U.S.gal
U.S. gal
- USgal l
- USgal L
- USgal impgal
US quart
USqt
US qt
1/4 US gal or 32 US fl oz
1.0 US qt (950 ml)
U.S.qt
U.S. qt
US pint
USpt
US pt
1/8 US gal or 16 US fl oz
1.0 US pt (0.47 l; 0.83 imp pt)
U.S.pt
U.S. pt
US fluid ounce
USoz
(USfloz)
US fl oz
1/128 US gal
1.0 US fl oz (30 ml)
- USoz ml
- USoz mL
- USoz impoz
U.S.oz
(U.S.floz)
U.S. fl oz
- U.S.oz ml
- U.S.oz mL
- U.S.oz impoz
US customary
dry measure
US dry barrel
USdrybbl
US dry bbl
105/32 US bsh
1.0 US dry bbl (0.12 m3)
U.S.drybbl
U.S. dry bbl
US bushel
USbsh
US bsh
2150.42 cubic inches by definition
1.0 US bsh (35 l; 8.0 US dry gal; 7.8 imp gal)
U.S.bsh
U.S. bsh
US bushel
USbu
US bu
2150.42 cubic inches by definition
1.0 US bu (35 l; 8.0 US dry gal; 7.8 imp gal)
U.S.bu
U.S. bu
US dry gallon
USdrygal
US dry gal
1/8 US bsh
Allows triple output units. See: full list.
1.0 US dry gal (4.4 l)
- USdrygal l
- USdrygal L
- USdrygal impgal
U.S.drygal
U.S. dry gal
- U.S.drygal l
- U.S.drygal L
- U.S.drygal impgal
US dry quart
USdryqt
US dry qt
1/32 US bsh
1.0 US dry qt (1,100 ml)
U.S.dryqt
U.S. dry qt
US dry pint
USdrypt
US dry pt
1/32 US bsh
1.0 US dry pt (550 ml)
U.S.drypt
U.S. dry pt
SPEED
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
SI
metre per second
m/s
m/s
US spelling: meter per second
1.0 m/s (3.3 ft/s)
- m/s ft/s (m/s foot/s)
non-SI metric
kilometre per hour
km/h
km/h
US spelling: kilometer per hour
1.0 km/h (0.62 mph)
- km/h mph
Imperial
&
US customary
mile per hour
mph
mph
1.0 mph (1.6 km/h)
- mph km/h
- mph kn
foot per second
ft/s (foot/s)
ft/s
long code "foot/s" outputs foot per second (and never feet)
1.0 ft/s (0.30 m/s)
- ft/s m/s
Maritime units
knot
kn (knot)
kn
1.0 kn (1.9 km/h; 1.2 mph)
- kn mph
FORCE
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
SI
giganewton
GN
GN
Allows triple output units. See: full list.
1.0 GN (220,000,000 lbf)
- GN LT-f
- GN LTf
- GN ST-f
- GN STf
meganewton
MN
MN
Allows triple output units. See: full list.
1.0 MN (220,000 lbf)
- MN LT-f
- MN LTf
- MN ST-f
- MN STf
kilonewton
kN
kN
Allows triple output units. See: full list.
1.0 kN (220 lbf)
- kN LT-f
- kN LTf
- kN ST-f
- kN STf
newton
N
N
1.0 N (0.22 lbf)
- N lb-f
- N lbf
- N oz-f
- N ozf
millinewton
mN
mN
1.0 mN (0.0036 ozf)
- mN oz-f
- mN ozf
- mN gr-f
- mN grf
micronewton
µN (uN)
μN
1.0 μN (0.0016 grf)
- µN gr-f
- µN grf
nanonewton
nN
nN
1.0 nN (1.6×10−6 grf)
- nN gr-f
- nN grf
cgs
megadyne
Mdyn
Mdyn
1.0 Mdyn (2.2 lbf)
kilodyne
kdyn
kdyn
1.0 kdyn (0.036 ozf)
dyne
dyn
(dyne)
dyn
1.0 dyn (0.016 grf)
millidyne
mdyn
mdyn
1.0 mdyn (1.6×10−5 grf)
Metric gravitational units
tonne-force
t-f
tf
1.0 tf (9.8 kN; 0.98 LTf; 1.1 STf)
tf
tf
kilogram-force
kg-f
kgf
1.0 kgf (9.8 N; 2.2 lbf)
kgf
kgf
gram-force
g-f
gf
1.0 gf (9.8 mN; 0.035 ozf)
gf
gf
milligram-force
mg-f
mgf
1.0 mgf (9.8 μN; 0.015 grf)
mgf
mgf
Avoirdupois-based units
poundal
pdl
pdl
1.0 pdl (0.14 N)
long ton-force
LT-f
LTf
1.0 LTf (10.0 kN)
- LT-f ST-f
LTf
long ton-force
- LTf STf
short ton-force
ST-f
STf
1.0 STf (8.9 kN)
- ST-f LT-f
STf
short ton-force
- STf LTf
pound-force
lb-f
lbf
1.0 lbf (4.4 N)
lbf
lbf
grain-force
gr-f
grf
1.0 grf (640 μN)
grf
grf
ENERGY
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
SI
gigajoule
GJ
GJ
1.0 GJ (280 kWh)
megajoule
MJ
MJ
1.0 MJ (0.28 kWh)
kilojoule
kJ
kJ
1.0 kJ (240 cal)
hectojoule
hJ
hJ
1.0 hJ (24 cal)
decajoule
daJ
daJ
1.0 daJ (2.4 cal)
joule
J
J
1.0 J (0.24 cal)
decijoule
dJ
dJ
1.0 dJ (0.024 cal)
centijoule
cJ
cJ
1.0 cJ (0.0024 cal)
millijoule
mJ
mJ
1.0 mJ (0.00024 cal)
microjoule
µJ (uJ)
μJ
1.0 μJ (2.4×10−7 cal)
nanojoule
nJ
nJ
1.0 nJ (2.4×10−10 cal)
cgs
megaerg
Merg
Merg
1.0 Merg (0.10 J)
kiloerg
kerg
kerg
1.0 kerg (0.10 mJ)
erg
erg
(none)
1.0 erg (0.10 μJ)
Watt-hour multiples
terawatt-hour
TWh
TWh
1.0 TWh (3.6 PJ)
TW.h
TW⋅h
gigawatt-hour
GWh
GWh
1.0 GWh (3.6 TJ)
GW.h
GW⋅h
megawatt-hour
MWh
MWh
1.0 MWh (3.6 GJ)
MW.h
MW⋅h
kilowatt-hour
kWh
kWh
1.0 kWh (3.6 MJ)
kW.h
kW⋅h
watt-hour
Wh
Wh
1.0 Wh (3.6 kJ)
W.h
W⋅h
Electron-
volt multiples
gigaelectronvolt
GeV
GeV
1.0 GeV (0.16 nJ)
megaelectronvolt
MeV
MeV
1.0 MeV (0.16 pJ)
kiloelectronvolt
keV
keV
1.0 keV (0.16 fJ)
electronvolt
eV
eV
1.0 eV (0.16 aJ)
millielectronvolt
meV
meV
1.0 meV (0.16 zJ)
Calorie multiples
calorie
Cal
Cal
The thermo-chemical calorie is the default definition. For others, see the full list.
1.0 Cal (4.2 kJ)
megacalorie
Mcal
Mcal
1.0 Mcal (4.2 MJ)
kilocalorie
kcal
kcal
1.0 kcal (4.2 kJ)
calorie
cal
cal
1.0 cal (4.2 J)
millicalorie
mcal
mcal
1.0 mcal (4.2 mJ)
pound/
ounce-foot/
inch-hour-minute-second
foot-poundal
ftpdl
ft⋅pdl
1.0 ft⋅pdl (0.042 J)
foot-pound force
ftlbf
ft⋅lbf
1.0 ft⋅lbf (1.4 J)
ftlb-f
ft⋅lbf
inch-pound force
inlbf
in⋅lbf
1.0 in⋅lbf (110 mJ)
inlb-f
in⋅lbf
inch-ounce force
inozf
in⋅ozf
1.0 in⋅ozf (7.1 mJ)
inoz-f
in⋅ozf
horsepower-hour
hph
hp⋅h
1.0 hp⋅h (0.75 kWh)
British thermal unit
British thermal unit
Btu
Btu
The International Steam Table British thermal unit is used. For others, see the full list.
1.0 Btu (1.1 kJ)
BTU
BTU
TNT-based units
gigatonne of TNT
GtTNT
(none)
1.0 gigatonne of TNT (4.2 EJ)
gigaton of TNT
GtonTNT
(none)
megatonne of TNT
MtTNT
(none)
1.0 megatonne of TNT (4.2 PJ)
megaton of TNT
MtonTNT
Mt
kilotonne of TNT
ktTNT
(none)
1.0 kilotonne of TNT (4.2 TJ)
kiloton of TNT
ktonTNT
kt
tonne of TNT
tTNT
(none)
1.0 tonne of TNT (4.2 GJ)
ton of TNT
tonTNT
(none)
Other
Hartree
Eh
Eh
1.0 Eh (27 eV)
rydberg
Ry
Ry
1.0 Ry (14 eV)
tonne of oil equivalent
toe
toe
1.0 toe (42 GJ)
barrel of oil equivalent
BOE
BOE
1.0 BOE (6.1 GJ)
cubic foot of natural gas
cuftnaturalgas (cufootnaturalgas)
Unit-code cufootnaturalgas will show "cubic foot of natural gas" if plural.
1.0 cubic foot of natural gas (1.1 MJ)
latm[convert: unknown unit]
latm
(none)
1.0 latm[convert: unknown unit]
Latm
Latm[convert: unknown unit]
impgalatm[convert: unknown unit]
impgalatm
(none)
1.0 impgalatm[convert: unknown unit]
USgalatm[convert: unknown unit]
USgalatm
(usgalatm)
(none)
1.0 USgalatm[convert: unknown unit]
U.S.galatm
(usgalatm)
U.S.galatm[convert: unknown unit]
TEMPERATURE
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
SI
K
K
K
Allows triple output units. See: full list.
1.0 K (−272.15 °C; −457.87 °F)
- K °C (K C)
- K °R (K R)
- K °F (K F)
°C
°C (C)
°C
1.0 °C (33.8 °F)
- °C K (C K)
- °C °R (C R)
- °C °F (C F)
Imperial
&
US customary
°R
°R (R)
°R
1.0 °R (0.556 K; −458.670 °F; −272.594 °C)
- °R K (R K)
- °R °C (R C)
- °R °F (R F)
°F
°F (F)
°F
1.0 °F (−17.2 °C)
- °F K (F K)
- °F °C (F C)
- °F °R (F R)
Celsius change
C-change
Used for temperature intervals instead of actual temperatures
Example: {{convert|5|C-change|0}} warmer
Result: 5 °C (9 °F) warmer
Fahrenheit change
F-change
Used for temperature intervals instead of actual temperatures
Example: {{convert|10|F-change|0}} colder
Result: 10 °F (6 °C) colder
MASS
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
SI
kilogram
kg
kg
Allows triple output units. See: full list.
1.0 kg (2.2 lb)
- kg lb
- kg st
gram
g
g
1.0 g (0.035 oz)
- g oz
milligram
mg
mg
1.0 mg (0.015 gr)
- mg gr
microgram
µg (ug)
μg
1.0 μg (1.5×10−5 gr)
non-SI metric
tonne
t
t
Allows triple output units. See: full list.
1.0 t (0.98 long tons; 1.1 short tons)
- t LT
- t ST
metric ton
MT
t
- MT LT
- MT ST
Avoirdupois
long ton
LT
(none)
2,240 lb
used mostly in the British Commonwealth.
Allows triple output units. See: full list.
1.0 long ton (1.0 t)
- LT t
- LT MT
- LT ST
long ton
long ton
short ton
ST
(none)
2,000 lb
used mostly in the US.
Allows triple output units. See: full list.
1.0 short ton (0.91 t)
- ST t
- ST MT
- ST LT
short ton
short ton
stone
st
st
14 lb
used mostly in the British Commonwealth except Canada.
Allows triple output units. See: full list.
1.0 st (14 lb; 6.4 kg)
- st kg
- st lb
pound
lb
lb
Allows triple output units. See: full list.
1.0 lb (0.45 kg)
- lb kg
- lb st
ounce
oz
oz
1.0 oz (28 g)
- oz g
drachm
drachm
(none)
1.0 drachm (1.8 g)
drachm
dram
(none)
grain
gr
gr
equivalent to the troy grain
1.0 gr (0.065 g)
Troy
troy ounce
ozt
ozt
1.0 ozt (1.1 oz; 31 g)
other
carat
carat
(none)
1.0 carat (0.20 g)
TORQUE
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
Industrial
SI
newton-metre
Nm
N⋅m
Triple combinations are also possible. See the full list.
1.0 N⋅m (0.74 lbf⋅ft)
- Nm kg.m
- Nm lb.ft
Non-SI metric
kilogram metre
kg.m
kg⋅m
1.0 kg⋅m (9.8 N⋅m; 7.2 lb⋅ft)
- kg.m Nm
- kg.m lb.ft
Imperial
&
US customary
pound force-foot
lb.ft
lb⋅ft
1.0 lb⋅ft (1.4 N⋅m)
- lb.ft Nm
- lb.ft kg-m
Scientific
SI
newton-metre
N.m
N⋅m
Triple combinations are also possible. See the full list.
1.0 N⋅m (0.74 lbf⋅ft)
- N.m kgf.m
- N.m lbf.ft
Non-SI metric
kilogram force-metre
kgf.m
kgf⋅m
1.0 kgf⋅m (9.8 N⋅m; 7.2 lbf⋅ft)
- kgf.m N.m
- kgf.m lbf.ft
Imperial
&
US customary
pound force-foot
lbf.ft
lbf⋅ft
1.0 lbf⋅ft (1.4 N⋅m)
- lbf.ft N.m
- lbf.ft kgf.m
DENSITY
(Full list)
system
unit
unit-
code
abbrev-
iation
notes
sample default
conversion
combination
output units
Metric
kilogram per cubic metre
kg/m3
kg/m3
1.0 kg/m3 (1.7 lb/cu yd)
- kg/m3 lb/ft3 (kg/m3 lb/cuft)
- kg/m3 lb/yd3 (kg/m3 lb/cuyd)
gram per cubic metre
g/m3
g/m3
1.0 g/m3 (0.0017 lb/cu yd)
- g/m3 kg/m3
- g/m3 lb/ft3 (g/cm3 lb/cuft)
- g/m3 lb/yd3 (g/cm3 lb/cuyd)
Imperial
&
US customary
pound per cubic foot
lb/ft3
lb/cu ft
1.0 lb/cu ft (0.016 g/cm3)
- lb/ft3 kg/m3 (lb/cu ft g/m3)
- lb/ft3 g/m3 (lb/cu ft g/m3)
pound per cubic yard
lb/yd3
lb/cu yd
1.0 lb/cu yd (0.59 kg/m3)
- lb/yd3 kg/m3 (lb/cuyd kg/m3)
- lb/yd3 g/m3 (lb/cuyd g/m3)
PRESSURE
unit
unit-
code
abbrev-
iation
sample default
conversion
gigapascal
GPa
GPa
1.0 GPa (150,000 psi)
megapascal
MPa
MPa
1.0 MPa (150 psi)
kilopascal
kPa
kPa
1.0 kPa (0.15 psi)
hectopascal
hPa
hPa
1.0 hPa (0.015 psi)
pascal
Pa
Pa
1.0 Pa (0.00015 psi)
millipascal
mPa
mPa
1.0 mPa (1.5×10−7 psi)
millibar
mbar
mbar
1.0 mbar (1.0 hPa)
mb
mb
decibar
dbar
dbar
1.0 dbar (10 kPa)
bar
bar
(none)
1.0 bar (100 kPa)
kilobarye
kBa
kBa
1.0 kBa (1.0 hPa)
barye
Ba
Ba
1.0 Ba (0.10 Pa)
standard atmosphere
atm
atm
1.0 atm (100 kPa)
torr
Torr
Torr
1.0 Torr (0.13 kPa)
millimetre of mercury
mmHg
mmHg
1.0 mmHg (0.13 kPa)
inch of mercury
inHg
inHg
1.0 inHg (3.4 kPa)
pound per square inch
psi
psi
1.0 psi (6.9 kPa)
FUEL EFFICIENCY
unit
unit-
code
notes
combinations
kilometres per litre
km/l (km/L)
Use km/L to get "km/L"
- km/l mpgimp
- km/l mpgus
litres per 100 kilometres
l/100 km (L/100 km)
Use L/100 km to get "L/100 km"
- l/100 km mpgimp
- l/100 km mpgus
litres per kilometre
l/km (L/km)
Use L/km to get "L/km"
- l/km impgal/mi
- l/km usgal/mi
miles per imperial gallon
mpgimp
- mpgimp mpgus
miles per US gallon
mpgus (mpgUS, mpgU.S.)
Use mpgUS to get "US"
Use mpgU.S. to get "U.S."
mpgus will give "U.S." if spelling is
set to US & "US" otherwise
- mpgus mpgimp
imperial gallons per mile
impgal/mi
- impgal/mi
US gallons per mile
usgal/mi (USgal/mi, U.S.gal/mi)
As above with the us vs US vs U.S.
- usgal/mi
The mpgUS, mpgU.S., USgal/mi vs U.S.gal/mi, km/L, L/100 km and L/km variants work within combinations also (making 36 combinations in total).
POWER
Watts, kilowatts, milliwatts, etc. are supported. As is horsepower (English & metric). Use standard abbreviations as input code (lowercase hp for horsepower, for example)
POPULATION DENSITY
unit
unit-
code
notes
combinations
inhabitants per square kilometre
PD/sqkm
PD stands for population density, i.e. humans (inhabitants)
- PD/sqkm PD/sqmi
per square kilometre
/sqkm
Used when the word 'inhabitants' would be inappropriate.
- /sqkm /sqmi
inhabitants per hectare
PD/ha
- PD/ha PD/acre
per hectare
/ha
- /ha /acre
inhabitants per square mile
PD/sqmi
PD stands for population density, i.e. humans (inhabitants)
- PD/sqmi PD/sqkm
per square mile
/sqmi
Used when the word 'inhabitants' would be inappropriate.
- /sqmi /sqkm
inhabitants per acre
PD/acre
- PD/acre PD/ha
per acre
/acre
- /acre /ha
COST PER UNIT MASS
unit
unit-
code
notes
combinations
dollars per pound
$/lb
"$" can mean US$, HK$, etc.
- (none)
dollars per kilogram
$/kg
- (none)
dollars per troy ounce
$/ozt
12 troy ounces in 1 troy pound
- (none)
Parameter list
Template:Navbar-collapsible
Option
=..
Description
Note
abbr=in
in
Use symbol for first (left-hand side) unit
Symbol ('abbreviation')
abbr=off
off
Use name for all units
Symbol ('abbreviation')
abbr=none
none
abbr=on
on
Use symbol for all units
Symbol ('abbreviation')
abbr=out
out
Use symbol for right-hand side unit (default)
Symbol ('abbreviation')
abbr=values
values
Show only input and output numbers, not units
Parts only
abbr=~
~
Shows both unit name and symbol
Symbol & name
adj=j
j
Join number and unit name using " " instead of a space
Join values
adj=mid|x=...
mid
User-specified text after the input unit; sets adj=on (adjective)
Word adding, adjective
adj=on
on
Unit name is adjective (singular and hyphenated)
Grammar, adjective
adj=pre|x=...
pre
User-specified text before input unit
Word adding
adj=ri0
ri0
Round input with precision 0
Rounding and sigfig
adj=ri1
ri1
Round input with precision 1
Rounding and sigfig
adj=ri2
ri2
Round input with precision 2
Rounding and sigfig
adj=ri3
ri3
Round input with precision 3
Rounding and sigfig
disp=b
b
Join input and output using " (...)" (default)
Join values
disp=sqbr
sqbr
Join input and output using " [...]"
Join values
disp=br
br
Join input and output using "<br/>"
Join values
disp=comma
comma
Join input and output using ", "
Join values
disp=or
or
Join input and output using " or "
Join values
disp=number
number
Display output number only
Parts only
disp=output number only
output number only
disp=out
out
Display only output number and name/symbol
Parts only
disp=output only
output only
disp=preunit|x=...
preunit
User-specified text before input and output units
Word adding
disp=table
table
Output is suitable for a table cell with align="right"
Table columns
disp=tablecen
tablecen
Output is suitable for a table cell with align="center"
Table columns
disp=unit
unit
Display input name/symbol only ( not input number, not output)
Parts only
disp=unit2
unit2
Display output name/symbol only (not input; not output number)
Parts only
disp=x|...
x
Join input and output using user-specified text
Word adding
comma=5
05
Only use comma for thousands separator if 5 or more digits
Number format
comma=gaps
gaps
Use gaps (space), not comma, for thousands separator
Number format
comma=gaps5
gaps5
Use gaps (space), but only if 5 or more digits
Number format
comma=off
off
No thousands separator
Number format
frac=N
N
Show imperial number in fractions, denominator=N
Number format, fraction
lk=in
in
Link left-hand side unit name or symbol
Unit link
lk=on
on
Link all unit names or symbols (but not twice for the same unit)
Unit link
lk=out
out
Link right-hand side unit name or symbol
Unit link
order=flip
flip
Inverts order of input, output measurements (conversion first)
Order
round=5
05
Rounds calculation to the nearest multiple of 5
Rounding and sigfig
round=25
25
Rounds calculation to the nearest multiple of 25
Rounding and sigfig
round=each
each
In a range, each number is rounded by the default rounding
Rounding and sigfig
sigfig=N
N
Round output number to N significant figures (N is a positive integer)
Rounding and sigfig
sortable=in
in
Output numeric hidden sort field for use in a sortable table (based on input)
Table sort
sortable=on
on
sortable=out
out
Output numeric hidden sort field for use in a sortable table (based on output)
Table sort
sp=us
us
Use U.S. spelling (like "meter" instead of default "metre")
Spelling U.S. names
spell=in
in
Spell input number in words
Spelling numbers
spell=In
In
Spell input number in words with first letter uppercase
Spelling numbers
spell=on
on
Spell input and output numbers in words
Spelling numbers
spell=On
On
Spell input and output numbers in words with first letter uppercase
Spelling numbers
$=€
$
Replace $-sign with a currency sign, for example in $/acre (no currency conversion happens)
Cost per unit
debug=yes
yes
Debugging only. In a sortable table: show the normally hidden sort key
Table sort
abbr=comma
comma
Deprecated. Use |comma=off
Number format
abbr=mos
mos
Deprecated. Use |x| or |by|
Range format
adj=1
01
Deprecated. Do not use. No need to deviate from MOS regarding plurals
Plural or singular
adj=flip
flip
Deprecated. Use |order=flip
Order
adj=nocomma
nocomma
Deprecated. Use |comma=off
Number format
disp=2
02
Deprecated. Use |disp=output only
Parts only
disp=5
05
Deprecated. Use |round=5
Rounding and sigfig
disp=flip
flip
Deprecated. Use |order=flip
Order
disp=flip5
flip5
Deprecated. Use |order=flip |round=5
Order, rounding
disp=nocomma
nocomma
Deprecated. Use |comma=off
Number format
disp=u2
u2
Deprecated. Use |disp=unit2
Parts only
near=5
05
Deprecated. Use |round=5
Rounding and sigfig
Deprecated options
This list:
Deprecated options should not be used. They may produce incorrect or undesired results and there is no guarantee that they will be supported in the future.
- abbr=comma is deprecated. Use comma=off instead
- abbr=mos, setting range separators, is deprecated (not MOS compliant). Use |by| or |x| instead
- adj=1 is deprecated. No need to deviate from MOS regarding plurals
- adj=flip is deprecated. Use order=flip instead
- adj=nocomma is deprecated. Use comma=off instead
- disp=2 is deprecated. Use disp=output only instead
- disp=5 is deprecated. Use round=5 instead
- disp=flip is deprecated. Use order=flip instead
- disp=flip5 is deprecated. Use |order=flip |round=5 instead
- disp=nocomma is depreated. Use comma=off instead
- disp=slash, disp=s, disp=/ are deprecated. Use disp=or instead
- disp=u2 is deprecated. Use disp=unit2 instead
- near=5 is deprecated. Use round=5 instead
- Range separator |xx| is deprecated (not MOS compliant). Use |x| instead
- Range separator |*| is deprecated (not MOS compliant). Use |x| instead
- Range separator |&| is deprecated. Use |and| instead
- Range separator |to-| is deprecated. Use |to(-)| instead
TemplateData
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Convert in articles based on its TemplateData.
TemplateData for Convert
Converts measurements to other units.
Template parameters[Edit template data]
Parameter Description Type Status value 1the value to convert
Number optional from unit 2
Line optional to units 3the unit to convert into
Line optional precision or suffix 4significant digits after decimal dot or, if negative, exponent of ten
Number optional link units lk“on” all, “in” input, “out” output or “off” no units
- Default
- off
Line optional abbreviation abbrdisplay for the units: “on” unit symbols, “off” all unit names in full words, “in” input unit symbol, “out” abbreviated output units, “values” no units at all
- Default
- out
Line optional spelling sp“us” display U.S. spelling of unit names
Line optional adjective adjadjective form (singular unit name appended by hyphen) “on” or “mid” to put conversion at end
Line optional conversion dispdisplay conversion result: “or” after ‘or’, “x” with custom prefix and suffix, “b” in parentheses, “table”/“tablecen”, “output only” alone, “output number only” alone and without unit, “unit” not at all but input unit; if the value is a number it is used as precision
- Default
- b
Line optional ordering order“flip” returns converted value first, input value second.
Line optional significant figures sigfignumber that sets the number of significant figures
Number optional rounding output round“5” rounds the output number to nearest multiple of 5, “25” to nearest multiple of 25, “each” rounds each number in a range
Line optional thousands separator commaSets or suppresses thousand separator in the numbers. “off” = no separator; “gaps”: use space not comma; “5” and “gaps5”: only add separator when number > 5 positions (10,000 or more)
- Default
- on
Line optional sort key sortable“on” generates a hidden sort key
Line optional
See also
- Template:Convert/old — Version as used until December 2013
- Template:Convert/units not supported
