Template:Convert/doc

{{#invoke:Fallback | autotranslate

      |base = Documentation subpage
      |lang = 
      |page = Template:Convert
    }}

{{

 {{#invoke:Namespace detect|main}}

| type = | image = | imageright = | class = | style = | textstyle = | text = The Template:Convert and most of its high-risk subtemplates have been protected so that only admins can edit them. Discuss proposed changes on the Convert talk-page. | small = | smallimage = | smallimageright = | smalltext = | subst = | date = | name = }}

Usage

This template shows measurement quantities as primary and converted secondary units (or ranges), with optional rounding, wikilinks, abbreviation, or US spellings, and various separators including:  parentheses "( )", "or", hyphens, comma, "to" or dashes. The can help users by generating correct conversions from one unit of measurement to another, particularly for more complex units. It's also useful by making the text adhere to the Manual of Style. The text the template generates does not differ from a plain text equivalent, however.

Styles include: distance "32 metres (Template:Hid{{#invoke:Math|precision_format| 104.98687664042 | 1-2 }} ft)" and "32 metres orTemplate:Hid{{#invoke:Math|precision_format| (32)*1/0.3048 | 1-2 }} feet"; temperature "18 °C (Template:Hid{{#invoke:Math|precision_format| ((18+273.15)*1.8-459.67) | 1-1 }} °F)"; mass "55.0 kg (Template:Hid{{#invoke:Math|precision_format| 121.25424420168 | 1-2 }} lb)" or "65 to 80 kg ( to lb)"; etc. For units see: Convert/list of units.

Options include:

lk=in, abbr=on, abbr=off, sp=us, adj=on, adj=mid, disp=x, disp=table and sortable=on (explained below). By default, output is rounded to match the precision of input; alternatives include: sigfig=3 or using the end parameter, such as "|1" to show tenths or "|-2" to show full 100's, etc.

Single value:

{{convert|value|in_unit|out_unit|round_to|...}}

Range of 2 values, or set of 3 or 4 (see below for list of range options):

{{convert|val1|range|val2 |in_unit|out_unit|round_to|...}}
{{convert/3 |val1|range|val2|words|val3|in_unit|out_unit|round_to|...}}
{{convert/4 |val1|words|val2|words|val3|words|val4|in_unit|out_unit|...}}

• Numbers must be entered in unformatted form (without commas). Values output by the template will be displayed formatted and with a true minus sign where appropriate. To specify with commas, re-code a number as {{formatnum:9,000,500|R}} (becomes 9000500).
• Optional parameters, in examples below, allow abbreviated units (abbr=on), or U.S. spellings (sp=us for meter), or hyphenation (adj=on), etc.
• For this template many levels of substitution are possible, hence doing this fully, step by step, is cumbersome. Use Special:ExpandTemplates instead.
• The template has very limited in-built capacity for dimensional analysis. It is therefore up to the user to ensure that most input and output units are compatible. Do not, for example, attempt to convert barrels to tonnes (but see {{bbl to t}}). Also beware of units with similar names; the code oz, for example, is for the avoirdupois ounce (a unit of mass), do not use this if you want fluid ounces. Note also that the code lb gives pounds mass, for pounds force use lbf.
• An attempt to convert a unit to itself, e.g., km to km, will result in a template loop.
• The range functionality is not fully implemented for all units, so experimentation may be required.
• This documentation page tends to lag behind in terms of what the template can do. For details see the talk page and its archives.

Examples

Single value

Input	Displays as
{{convert|3.21|kg|lb}}	3.21 kilograms (Template:Hid{{#invoke:Math|precision_format| 7.0768386161346 | 1-0 }} lb)
{{convert|3.21|kg|lb|0}}	precision_format| 7.0768386161346 | 0}} lb)
{{convert|10|kg|lb|disp=or}}	10 kilograms orTemplate:Hid{{#invoke:Math|precision_format| (10)*1/0.45359237 | 1-1 }} pounds
{{convert|6|ft|5|in|m}}	6 feet 5 inches (Template:Hid{{#invoke:Math|precision_format| 1.9558 | 1-0 }} m)
{{convert|10|mi}}	10 miles (Template:Hid{{#invoke:Math|precision_format| 16.09344 | 1-1 }} km)
{{convert|100|mpgus}}	100 miles per US gallon (Template:Hid{{#invoke:Math|precision_format| 1/(100*(480,000/1.12903)*0.00000001) | 1-0 }} L/100 km;Template:Hid{{#invoke:Math|precision_format| 100*(480,000/1.12903)/(1,609,344/4.54609) | 1-2 }} mpg-imp)
{{convert|120|km/h}}	120 kilometres per hour (Template:Hid{{#invoke:Math|precision_format| 74.56454306848 | 1-1 }} mph)
{{convert|18|°C|°F}}	18 °C (Template:Hid{{#invoke:Math|precision_format| ((18+273.15)*1.8-459.67) | 1-1 }} °F)
{{convert|1250|sqft|m2|lk=in|sigfig=2}}	1,250 square feet ({{#invoke:Math|precision_format| 116.1288 | (2-2-1)}} m2) Note 'lk=in' links only the input unit. This example is for illustration only, common units of measurement should not be linked. See: wp:overlink.
{{convert|20.5|m3|cuyd|lk=out|abbr=on}}	precision_format| 26.812987695945 | 1}} cu yd) Note 'lk=out' links only the output unit, cu yd.
{{convert|641|acre|ha sqmi|lk=on}}	641 acres (Template:Hid{{#invoke:Math|precision_format| 259.4034966502 | 1-2 }} ha;Template:Hid{{#invoke:Math|precision_format| 1.001562499901 | 1-0 }} sq mi) Note 'lk=on' links all units. Per guidelines, common units should not be linked. See: wp:overlink.
{{convert|641|acre|ha sqmi|2|lk=on}}	641 acres ({{#invoke:Math|precision_format| 259.4034966502 | 2}} ha; {{#invoke:Math|precision_format| 1.001562499901 | 2}} sq mi) Although 640 acres equals 1 square mile; 641 acres rounded to two decimal places equals 1.00 sq mi.

Range of 2 values

Note: not yet operational for all units

Input	Displays as
{{convert|60|and|170|kg|lb}}	60 and 170 kilograms ( and lb)
{{convert|60|to|170|kg|lb}}	60 to 170 kilograms ( to lb)
{{convert|60|to(-)|170|kg|lb}}	60 to 170 kilograms ( )
{{convert|60|-|170|kg|lb}}	60–170 kilograms ( )
{{convert|41|to|50|F|C}}	41 to 50 °F (5 to 10 °C)
{{convert|41|-|50|F|K}}	41–50 °F (278–326 K)
{{convert|60|x|120|m|ft}}	60 by 120 metres ( ×  ft)
{{convert|60|+/-|10|m|ft}}	60 ± 10 metres (Template:Hid{{#invoke:Math|precision_format| ( 60 )*((0.5)+(0)+1*2-((0.5)+(0)+1))/0.3048 | 1-2 }} ± Template:Hid{{#invoke:Math|precision_format| ( 10 )*((0.5)+(0)+1*2-((0.5)+(0)+1))/0.3048 | 1-1 }} ft)
{{convert|19|to|27|L|USgal}}	19 to 27 litres ( to US gal)
{{convert|5|to|7|L|USgal|abbr=mos}}	5 litres to 7 litres ( to US gal)Template:Convert/track/abbr/mos
{{convert|4|-|9|L|USgal|abbr=off}}	4–9 litres ( )

The following conversions are currently not available as a range of values:

• Some imperial and US gallon-based units
• Other fuel-consumption units, except "mpg" or "L100km" shown above.
• Large scale units (e3, e6, e9)
• Combination-based units (ft&in, st&lb, lb&oz) due to complexity of the conversion.

Range/set of 3 or 4 values

Note: not yet operational for all units

For {{convert/3}} or {{convert/4}}, the separator words can be any text.

Parameters

Parameters
Use US spelling	attach |sp=us
Make units linked	attach |lk=on   to link all units (default: lk=off) attach |lk=in   to link only the input units attach |lk=out  to link only the output units (The manual of style suggests that you should not link common units of measurement).
Use the adjective form, or insert mid-text words	attach |adj=on (e.g. "190-foot (58 m) bridge" instead of "190 feet..."). This produces the adjective form—the unit name in the singular with a hyphen (according to the Manual of Style). attach |adj=mid (e.g. "190-foot bridge (58 m)" as: |adj=mid|bridge or "190-foot-long bridge (58 m)" as: |adj=mid|-long bridge) Note 1: Any rounding-parameter should follow the mid-text: "text|0". Note 2: For adj=mid, must specify both input & output unit-codes. For example, to convert feet, use "ft|m" or "ft|0":   • {{convert|9|ft|m|adj=mid|-long}} → 9-foot-long (2.7 m) To default the output unit-code, set parameter 3 to: 0.
Abbreviate units, or not	attach |abbr=on to show unit symbols attach |abbr=off   to show all unit names in full words attach |abbr=in to abbreviate input units attach |abbr=out to abbreviate output units attach |abbr=values to suppress unit names & show only values. So, {{convert|6|mi|abbr=values}} gives: 6 (Template:Hid{{#invoke:Math|precision_format| ( 6 )*1,609.344/1,000 | 1-0 }}).
Change "( )" to display other separators	disp=comma to put comma, not brackets/parentheses attach |disp=or to put "or" between units. The default value is:  disp=b for brackets/parentheses.
Change "( )" to customized separators	disp=x| (begin | end) to show "xx (begin yy end)" See example 1 attach |disp=x|; to show "xx; yy" See example 2 attach |disp=x| (same as |) to show "xx (same as yy)". See example 3 Example 1: {{convert|9|km|mi|disp=x| [|]}}→9 kilometres [5.6 mi] (note space before [|) Example 2: {{convert|9|km|mi|disp=x|;}}→9 kilometres;5.6 mi Example 3: {{convert|10|km|mi|disp=x| (about |)}}→10 kilometres (about 6.2 mi) (note spaces used within the code).
Display output only	disp=output only to show result number & unit attach |disp=output number only to show just number Note when using "disp=output only" then the unit name can still be shown as full words by abbr=off or linked by lk=on.
Display units inverted as reverse order	disp=flip  to reverse the order & show output unit first. So, {{convert|6|km|disp=flip}} shows "3.7 miles (6 km)". To get symbol "mi" use abbr=in, to abbreviate the input unit (left-side unit).
Display unit name (only)	disp=unit to show the unit name for a symbol The unit name will be plural when the amount is not 1, or hyphenated when adj=on. So, {{convert|2|cuyd|disp=unit}} shows "cubic yards" plural.
Display amounts as table cells	disp=table (or |disp=tablecen) Note: For use in tables, the template must start on a new line after a pipe. Only the number will be displayed unless you set |abbr=on, |lk=on, |lk=in or |lk=out. Example: here
Round to a specified number of significant figures	attach |sigfig={some integer greater than zero}. In the case of temperatures Celsius or Fahrenheit this refers to the difference with the absolute-zero temperature. For example, at room temperature two significant digits means rounded to tens of degrees.
Round by 5	disp=5  to round the output amount to the nearest 5 units. Not supported for all options.
Let Convert decide the unit to convert to	skip the precision parameter (the 3rd or 4th unnamed parameter) e.g. {{convert|100|km|kn}} gives 100 kilometres (Template:Hid{{#invoke:Math|precision_format| 194,384.44924406 | 1-5 }} kn) and {{convert|100|km}} gives 100 kilometres (Template:Hid{{#invoke:Math|precision_format| 62.137119223733 | 1-1 }} mi).
Display input value with a fraction	precision_format| 9.525 | 3}} mm) or {{convert|11+1/4|in|cm|2|abbr=on}} → 11+1⁄4 in ({{#invoke:Math|precision_format| 28.575 | 2}} cm) For negative amounts, use two minus signs (hyphens): -11-1/4.
Generate a hidden sort key for use with a sortable table	attach |sortable=on to generate a hidden sort key so that sortable tables will sort correctly. This uses {{ntsh}} to generate a sort key from the first numeric value. It ignores any additional values, ie, if you use 6|ft|2|in as the value, it will only use the 6 for the sort key. This will cause numeric values to sort in numeric order, ie: 5, 10, 15 instead of 10, 15, 5.

Parameters still under construction

Parameters still under construction. May not work in all situations
disp=5	The output will be rounded to the nearest 5 units. Might not work when linking unit names.
disp=tablecen	Similar to disp=table except that the values with be centered within the column. See the tables at La Nouvelle branch, BM-21 Grad for in use examples.
disp=comma	The two values will be separated by a comma, for situations where the first value is already within parentheses. See the Geography tables on Labrador for an example.
abbr=in	Abbreviates only the input unit.
abbr=out	Abbreviates only the output unit.
abbr=comma	"Abbreviates" (removes) commas. For ranges, using abbr=comma conflicts with internal options, so instead, append "nocomma" to a range-word: tonocomma, bynocomma, andnocomma, -nocomma & xnocomma.
abbr=mos	For ranges, abbreviates with the input unit repeated, twice. Not to be confused with the specifications at MOS:NUM.
disp=br	This separates input and output units with a forced line break. This can be useful in tables with limited horizontal space.
disp=sqbr	Shows square brackets "[ ]" instead of parentheses "( )" in output. Example: 55 miles [89 km]. This option can be used in direct quotes, to show conversions in editorial brackets. See: attach |disp=x|[|], above, as another way of showing brackets "[ ]".

Rounding

Convert supports four types of rounding:

Rounding to a given 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 ¹⁄₁₀ 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.

Rounding to a given number of significant figures

Specify the desired number of significant figures using |sigfig={some integer greater than zero} as noted above.

Default rounding

If neither the desired precision nor the desired number of significant figures is specified, the conversion will be rounded either to a comparable precision as 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 the most precise. An exception to this is temperature, wherein 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 the most precise.

Examples of default rounding
Input	Displays as	Note
{{convert|550|ft|m|0}}	precision_format| 167.64 | 0}} m)	Approximate value is 167.64 m
{{convert|550|ft|m}}	550 feet (Template:Hid{{#invoke:Math|precision_format| 167.64 | 1-2 }} m)	Rounds to 170, when approximate value is 167.64 m
{{convert|500|ft|m|0}}	precision_format| 152.4 | 0}} m)	Approximate value is 152.4 m
{{convert|500|ft|m}}	500 feet (Template:Hid{{#invoke:Math|precision_format| 152.4 | 1-2 }} m)	Rounds to 150, when approximate value is 152.4 m

Units supported

See also: Convert/list of units

The table below lists units supported by this template. It is divided up according to the quantity being measured. Not all supported units are listed here; there are links to more complete lists for each quantity.

The codes listed in the code column (column 3) are accepted as input by the template. These can be used as the second or third unnamed parameter. For some units there exist alternative codes. These are listed in brackets and have been incorporated to make the code more flexible for editors, e.g. °F or F may be entered.

The codes listed in the combinations column (column 7) can be used to produce multiple conversions. They can only be used as the third unnamed parameter, e.g. {{convert|55|nmi|km mi}} produces "55 nautical miles (Template:Hid{{#invoke:Math|precision_format| 101.86 | 1-2 }} km;Template:Hid{{#invoke:Math|precision_format| 63.292869641295 | 1-1 }} mi)".

Abridged list of units supported by {{Convert}}
Explanation
system	unit	unit- code	symbol or abbrev.	notes	conversion factor	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	conversion factors used to convert to and from the SI base unit	output codes for multiple conversions
LENGTH (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/m	combination output units
SI	megametre	Mm	Mm	US spelling: megameter	1,000,000
	kilometre	km	km	US spelling: kilometer	1,000	km mi
	metre	m	m	US spelling: meter	1	m ft m ftin
	centimetre	cm	cm	US spelling: centimeter	0.01	cm in
	millimetre	mm	mm	US spelling: millimeter	0.001	mm in
	micrometre	μm (um)	µm	US spelling: micrometer	0.000001
	nanometre	nm	nm	US spelling: nanometer	0.000000001
non-SI metric	ångström	Å (angstrom)	Å		0.0000000001
Imperial & US customary	mile	mi	mi		1,609.344	mi km
	furlong	furlong			201.168
	chain	chain			20.1168
	rod	rd	rd	For other names of this unit see the full list.	5.0292
	fathom	fathom		assumes 1 fathom ≡ 6 ft	1.8288
	yard	yd	yd	assumes the international definition	0.9144
	foot	ft (foot)	ft	Code "foot" will show "foot" if plural.	0.3048	ftin (feet and inches) ft m (foot m)
	inch	in	in		0.0254	in cm in mm
Other	nautical mile	nmi	nmi	the international standard nautical mile For other nautical miles see the full list.	1,852
	parsec	pc	pc		Template:Hid{{#invoke:Math|precision_format| (30856775814671916*10^-16) | 1-0 }}×10^16
	light-year	ly	ly		Template:Hid{{#invoke:Math|precision_format| (9460730472580800*10^-15) | 1-0 }}×10^15
	astronomical unit	AU	AU		149,597,870,700
AREA (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/m2	combinations
SI	square kilometre	km2	km2	US spelling: square kilometer	1,000,000	km2 sqmi
	square metre	m2	m2	US spelling: square meter	1	m2 sqft
	square centimetre	cm2	cm2	US spelling: square centimeter	0.0001	cm2 sqin
	square millimetre	mm2	mm²	US spelling: square millimeter	0.000001	mm2 sqin
non-SI metric	hectare	ha	ha		10,000
Imperial & US customary	square mile	sqmi	sq mi		2,589,988.110336	sqmi km2
	acre	acre			4,046.856422
	square yard	sqyd	sq yd		0.83612736
	square foot	sqft (sqfoot)	sq ft	Code "sqfoot" will show "square foot" if plural.	0.09290304	sqft m2 (sqfoot m2)
	square inch	sqin	sq in		0.00064516	sqin cm2
Other	square nautical mile	sqnmi	sq nmi		3,429,904
	dunam	dunam		For alternative spellings and definitions see the full list	1,000
		tsubo			(400/121)
VOLUME (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/m3	combinations
SI	cubic metre	m3	m3	US spelling: cubic meter one kilolitre	1
	cubic centimetre	cm3	cm3	US spelling: cubic centimeter one millilitre	0.000001
		cc	cc
	cubic millimetre	mm3	mm³	US spelling: cubic millimeter	0.000000001
non-SI metric	kilolitre	kl	kl	US spelling: kiloliter one cubic metre	1
		kL	kL
	litre	l	l	US spelling: liter one cubic decimetre Allows triple output units. See: full list.	0.001	l impgal l USgal l U.S.gal l USdrygal l U.S.drygal
		L	L			L impgal L USgal L U.S.gal L USdrygal L U.S.drygal
	centilitre	cl	cl	US spelling: centiliter	0.00001
		cL	cL
	millilitre	ml	ml	US spelling: milliliter one cubic centimetre	0.000001	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		0.764554857984
	cubic foot	cuft (cufoot)	cu ft	Code "cufoot" will show "cubic foot" if plural.	0.028316846592
	cubic inch	cuin	cu in		0.000016387064
Imperial	barrel	impbbl	imp bbl	36 imp gal	0.16365924
	bushel	impbsh	imp bsh	8 imp gal	0.03636872
		impbu	imp bu
	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.	0.00454609	impgal l impgal L impgal USgal impgal U.S.gal impgal USdrygal impgal U.S.drygal
	quart	impqt	imp qt	1/4 imp gal or 40 imp fl oz	0.0011365225
	pint	imppt	imp pt	1/8 imp gal or 20 imp fl oz	0.00056826125
	fluid ounce	impoz(impfloz)	imp fl oz	1/160 imp gal	0.0000284130625	impoz USoz impoz U.S.oz impoz ml impoz mL
US customary liquid measure	barrel	USbbl	US bbl	31½ US gal used for liquids except for oil and beer (see the full list)	0.119240471196
		U.S.bbl	bbl
	barrel	oilbbl	bbl	42 US gal	0.158987294928
	beer barrel	USbeerbbl (usbeerbbl)	US bbl		0.117347765304
		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.	0.003785411784	USgal l USgal L USgal impgal
		U.S.gal	U.S. gal			USgal l USgal L USgal impgal
	quart	USqt	US qt	1/4 US gal or 32 US fl oz	0.000946352946
		U.S.qt	U.S. qt
	pint	USpt	US pt	1/8 US gal or 16 US fl oz	0.000473176473
		U.S.pt	U.S. pt
	fluid ounce	USoz (USfloz)	US fl oz	1/128 US gal	0.0000295735295625	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	barrel	USdrybbl	US bbl	105/32 US bsh	0.11562819898508
		U.S.drybbl	U.S. bbl
	bushel	USbsh	US bsh	2150.42 cubic inches by definition	0.03523907016688
		U.S.bsh	U.S. bsh
	bushel	USbu	US bu	2150.42 cubic inches by definition	0.03523907016688
		U.S.bu	U.S. bu
	dry gallon	USdrygal	US dry gal	1/8 US bsh Allows triple output units. See: full list.	0.00440488377086	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
	dry quart	USdryqt	US dry qt	1/32 US bsh	0.001101220942715
		U.S.dryqt	U.S. dry qt
	dry pint	USdrypt	US dry pt	1/32 US bsh	0.0005506104713575
		U.S.drypt	U.S. dry pt
SPEED (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/(m/s)	combinations
SI	metre per second	m/s	m/s	US spelling: meter per second	1	m/s ft/s (m/s foot/s)
non-SI metric	kilometre per hour	km/h	km/h	US spelling: kilometer per hour	(5/18)	km/h mph
Imperial & US customary	mile per hour	mph	mph		0.44704	mph km/h mph kn
	foot per second	ft/s (foot/s)	ft/s	Code "foot/s" will show "foot per second" if plural.	0.3048	ft/s m/s
Maritime units	knot	kn (knot)	kn		(4.63/9)	kn mph
FORCE (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/N	combination output units
SI	giganewton	GN	GN	Allows triple output units. See: full list.	1,000,000,000	GN LT-f GN LTf GN ST-f GN STf
	meganewton	MN	MN	Allows triple output units. See: full list.	1,000,000	MN LT-f MN LTf MN ST-f MN STf
	kilonewton	kN	kN	Allows triple output units. See: full list.	1,000	kN LT-f kN LTf kN ST-f kN STf
	newton	N	N		1	N lb-f N lbf N oz-f N ozf
	millinewton	mN	mN		0.001	mN oz-f mN ozf mN gr-f mN grf
	micronewton	μN (uN)	µN		0.000001	μN gr-f μN grf
	nanonewton	nN	nN		0.000000001	nN gr-f nN grf
cgs	megadyne	Mdyn	Mdyn		10
	kilodyne	kdyn	kdyn		0.01
	dyne	dyn (dyne)	dyn		0.00001
	millidyne	mdyn	mdyn		0.00000001
Metric gravitational units	tonne-force	t-f	tf		9,806.65
		tf	tf
	kilogram-force	kg-f	kgf		9.80665
		kgf	kgf
	gram-force	g-f	gf		0.00980665
		gf	gf
	milligram-force	mg-f	mgf		0.00000980665
		mgf	mgf
Avoirdupois-based units	poundal	pdl	pdl		0.138254954376
	long ton-force	LT-f	LTf		9,964.01641818352	LT-f ST-f
		LTf	LTf			LTf STf
		ST-f	STf		8,896.443230521	ST-f LT-f
		STf	STf			STf LTf
	pound-force	lb-f	lbf		4.4482216152605
		lbf	lbf
	grain-force	gr-f	grf		0.0006354602307515
		grf	grf
ENERGY (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/J	combinations
SI	gigajoule	GJ	GJ		1,000,000,000
	megajoule	MJ	MJ		1,000,000
	kilojoule	kJ	kJ		1,000
	hectojoule	hJ	hJ		100
	decajoule	daJ	daJ		10
	joule	J	J		1
	decijoule	dJ	dJ		0.1
	centijoule	cJ	cJ		0.01
	millijoule	mJ	mJ		0.001
	microjoule	μJ (uJ)	µJ		0.000001
	nanojoule	nJ	nJ		0.000000001
cgs	megaerg	Merg	Merg		0.1
	kiloerg	kerg	kerg		0.0001
	erg	erg	erg		0.0000001
Watt-hour multiples	terawatt-hour	TWh	TWh		Template:Hid{{#invoke:Math|precision_format| (3600000000000000*10^-15) | 1-0 }}×10^15
		TW.h	TW·h
	gigawatt-hour	GWh	GWh		Template:Hid{{#invoke:Math|precision_format| (3600000000000*10^-12) | 1-0 }}×10^12
		GW.h	GW·h
	megawatt-hour	MWh	MWh		3,600,000,000
		MW.h	MW·h
	kilowatt-hour	kWh	kWh		3,600,000
		kW.h	kW·h
	watt-hour	Wh	Wh		3,600
		W.h	W·h
Electron- volt multiples
	gigaelectronvolt	GeV	GeV		0.0000000001602176487
	megaelectronvolt	MeV	MeV		Template:Hid{{#invoke:Math|precision_format| (0.0000000000001602176487*10^--13) | 1-0 }}×10^−13
	kiloelectronvolt	keV	keV		Template:Hid{{#invoke:Math|precision_format| (0.0000000000000001602176487*10^--16) | 1-0 }}×10^−16
	electronvolt	eV	eV		Template:Hid{{#invoke:Math|precision_format| (0.0000000000000000001602176487*10^--19) | 1-0 }}×10^−19
	millielectronvolt	meV	meV		Template:Hid{{#invoke:Math|precision_format| (0.0000000000000000000001602176487*10^--22) | 1-0 }}×10^−22
Calorie multiples	calorie	Cal	Cal	The thermo-chemical calorie is the default definition. For others, see the full list.	4,184
	megacalorie	Mcal	Mcal		4,184,000
	kilocalorie	kcal	kcal		4,184
	calorie	cal	cal		4.184
	millicalorie	mcal	mcal		0.004184
pound/ ounce-foot/ inch-hour-minute-second	foot-poundal	ftpdl	ft·pdl		0.0421401100938048
	foot-pound force	ftlbf	ft·lbf		1.3558179483314004
		ftlb-f	ft·lbf
	inch-pound force	inlbf	in·lbf		0.1129848290276167
		inlb-f	in·lbf
	inch-ounce force	inozf	in·ozf		0.00706155181422604375
		inoz-f	in·ozf
	horsepower-hour	hph	hp·h		2,684,519.537696172792
British thermal unit	British thermal unit	Btu	Btu	The International Steam Table British thermal unit is used. For others, see the full list.	1,055.05585262
		BTU	BTU
TNT-based units	gigatonne of TNT	GtTNT			Template:Hid{{#invoke:Math|precision_format| (4184000000000000000*10^-18) | 1-0 }}×10^18
	gigaton of TNT	GtonTNT
	megatonne of TNT	MtTNT			Template:Hid{{#invoke:Math|precision_format| (4184000000000000*10^-15) | 1-0 }}×10^15
	megaton of TNT	MtonTNT	Mt
	kilotonne of TNT	ktTNT			Template:Hid{{#invoke:Math|precision_format| (4184000000000*10^-12) | 1-0 }}×10^12
	kiloton of TNT	ktonTNT	kt
	tonne of TNT	tTNT			4,184,000,000
	ton of TNT	tonTNT
Other
	Hartree	Eh	Eh		Template:Hid{{#invoke:Math|precision_format| (0.00000000000000000435974417*10^--18) | 1-0 }}×10^−18
	rydberg	Ry	Ry		Template:Hid{{#invoke:Math|precision_format| (0.0000000000000000021798741*10^--18) | 1-0 }}×10^−18
	tonne of oil equivalent	toe	toe		41,868,000,000
	barrel of oil equivalent	BOE	BOE		6,117,863,200
	cubic foot of natural gas	cuftnaturalgas (cufootnaturalgas)		Unit-code cufootnaturalgas will show "cubic foot of natural gas" if plural.	1,055,055.85262
	litre-atmosphere	latm	l·atm		101.325
		Latm	L·atm
	gallon-atmosphere	impgalatm	imp gal·atm		460.63256925
	gallon-atmosphere	USgalatm (usgalatm)	US gal·atm		383.5568490138
		U.S.galatm (usgalatm)	U.S. gal·atm
TEMPERATURE (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion to kelvin	combinations
SI	kelvin	K	K	Allows triple output units. See: full list.	[K]	K °C (K C) K °R (K R) K °F (K F)
	degree Celsius	°C (C)	°C		([°C]+273.15)	°C K (C K) °C °R (C R) °C °F (C F)
Imperial & US customary	degree Rankine	°R (R)	°R		([°R]/1.8)	°R K (R K) °R °C (R C) °R °F (R F)
	degree Fahrenheit	°F (F)	°F		(([°F]+459.67)/1.8)	°F K (F K) °F °C (F C) °F °R (F R)
	Celsius change	C-change		Used for temperature intervals instead of absolute temperatures Example:  {{convert|5|C-change|0}} warmer Result: 5 °C ({{#invoke:Math|precision_format| 5*1.8 | 0}} °F) warmer
	Fahrenheit change	F-change		Used for temperature intervals instead of absolute temperatures Example:  {{convert|10|F-change|0}} colder Result: 10 °F ({{#invoke:Math|precision_format| (10/1.8) | 0}} °C) colder
MASS (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/kg	combination output units
SI	kilogram	kg	kg	Allows triple output units. See: full list.	1	kg lb kg st
	gram	g	g		0.001	g oz
	milligram	mg	mg		0.000001	mg gr
	microgram	μg (ug)	µg		0.000000001
non-SI metric	tonne	t	t	Allows triple output units. See: full list.	1,000	t LT t ST
	metric ton	MT	t			MT LT MT ST
Avoirdupois	long ton	LT		2,240 lb used mostly in the British Commonwealth. Allows triple output units. See: full list.	1,016.0469088	LT t LT MT LT ST
		long ton
	short ton	ST		2,000 lb used mostly in the US. Allows triple output units. See: full list.	907.18474	ST t ST MT ST LT
		short ton
	stone	st	st	14 lb used mostly in the British Commonwealth except Canada. Allows triple output units. See: full list.	6.35029318	st kg st lb
	pound	lb	lb	Allows triple output units. See: full list.	0.45359237	lb kg lb st
	ounce	oz	oz		0.028349523	oz g
	drachm	drachm			0.001771845195
	drachm	dram
	grain	gr	gr	equivalent to the troy grain	0.00006479891
Troy	troy ounce	ozt	ozt		0.0311034768
other	carat	carat			0.0002
TORQUE (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/N·m	combinations
Industrial
SI	newton metre	Nm	N·m	Triple combinations are also possible. See the full list.	1	Nm kg-m Nm ft-lb
Non-SI metric	kilogram-meter	kg-m	kg-m		9.80665	kg-m Nm kg-m ft-lb
Imperial & US customary	foot-pound	ft-lb	ft-lb		1.3558	ft-lb Nm ft-lb kg-m
Scientific
SI	newton metre	N-m	N·m	Triple combinations are also possible. See the full list.	1	N-m kgf-m N-m lbf-ft
Non-SI metric	kilogram-force meter	kgf-m	kgf·m		9.80665	kgf-m N-m kgf-m lbf-ft
Imperial & US customary	pound-foot	lbf-ft	lbf·ft		1.3558	lbf-ft N-m lbf-ft kgf-m
PRESSURE
	unit	unit- code	abbrev- iation		conversion factor/Pa
	gigapascal	GPa	GPa		1,000,000,000	‎
	megapascal	MPa	MPa		1,000,000	‎
	kilopascal	kPa	kPa		1,000	‎
	hectopascal	hPa	hPa		100	‎
	pascal	Pa	Pa		1	‎
	millipascal	‎mPa‎	mPa		0.001	‎
	millibar	mbar	mbar		100	‎
		mb	mb			‎
	decibar	‎dbar	dbar		10,000	‎
	bar	bar	bar		100,000	‎
	kilobarye	kBa	kBa		100	‎
	barye	‎Ba	Ba		0.1	‎
	standard atmosphere	atm	atm		101,325	‎
	torr	Torr	Torr		(20,265/152)	‎
	millimetre of mercury	mmHg	mmHg		133.322387415	‎
	inch of mercury	inHg	inHg		3,386.388640341	‎
	pound per square inch	psi	psi		(444,822,161.52605 / 64,516)
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)

Examples

• Monitor quality or look at examples at {{Convert/check}}.

See also

• {{Convinfobox}} for use in infoboxes
• {{Bbl to t}} for converting barrel of oil to tonnes
• {{CwtQtrLb to kg}} for converting long hundred weights, quarters and pounds into kilograms
• {{Decdeg}} for converting degrees, minutes and seconds to decimal degrees
• {{HMS2Deg}} for converting hour angles, given in hours, minutes and seconds, to decimal degrees
• {{Miles-chains}} for converting miles and chains to kilometres linking "chains"
• {{Pop density}} for converting a population and area to a density
• {{Inflation}} for calculating inflation of Consumer Price Index related prices
• {{Metricate}}
• {{RailGauge}} for converting rail (track) gauges
• {{Convert/scale}} with custom formula for converting any linearly related units
• Bug 235: Auto unit conversion