Template:Convert

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

Usage

This template shows measurement quantities as primary and converted secondary units (or ranges), with optional rounding, wikilinks, abbreviation, or UK 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 books' manuals of style. The text the template generates does not differ from a plain text equivalent, however.

Styles include: distance "32 meters (105 ft)" and "32 meters or 105 feet"; temperature "18 °C (64 °F)"; mass "55.0 kg (121 lb)" or "65 to 80 kg (140 to 180 lb)"; etc. For units see: Convert/list of units.

Options include:

lk=in, abbr=on, abbr=off, sp=uk, 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:

{{</nowiki>convert|''value''|''in_unit''|''out_unit''|''round_to''<nowiki>|...}}

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

 {{convert|''val1''|''range''|''val2'' |''in_unit''|''out_unit''|''round_to''|...}}
 {{123;convert/3 |''val1''|''range''|''val2''|''words''|''val3''|''in_unit''|''out_unit''|''round_to''|...}}

• 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.K. spellings (sp=uk for metre), 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. 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 (7.1 lb)
{{convert|3.21|kg|lb|0}}	3.21 kilograms (7 lb)
{{convert|10|kg|lb|disp=or}}	10 kilograms or 22 pounds
{{convert|6|ft|5|in|m}}	6 feet 5 inches (1.96 m)
{{convert|10|mi}}	10 miles (16 km)
{{convert|100|mpgus}}	100 miles per U.S. gallon (2.4 L/100 km; 120 mpg-imp)
{{convert|120|km/h}}	120 kilometers per hour (75 mph)
{{convert|18|°C|°F}}	18 °C (64 °F)
{{convert|1250|sqft|m2|lk=in|sigfig=2}}	1,250 square feet (120 m2) Note 'lk=in' links only the input unit. This example is for illustration only, common units of measurement should not be linked.
{{convert|20.5|m3|cuyd|lk=out|abbr=on}}	20.5 m3 (26.8 cu yd) Note 'lk=out' links only the output unit, cu yd.
{{convert|641|acre|ha sqmi|lk=on}}	641 acres (259 ha; 1.002 sq mi) Note 'lk=on' links all units. Common units should not be linked.
{{convert|641|acre|ha sqmi|2|lk=on}}	641 acres (259.40 ha; 1.00 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 (130 and 370 lb)
{{convert|60|to|170|kg|lb}}	60 to 170 kilograms (130 to 370 lb)
{{convert|60|to(-)|170|kg|lb}}	60 to 170 kilograms (130–370 lb)
{{convert|60|-|170|kg|lb}}	60–170 kilograms (130–370 lb)
{{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 meters (200 × 390 ft)
{{convert|60|+/-|10|m|ft}}	60 ± 10 meters (200 ± 33 ft)
{{convert|19|to|27|L|USgal}}	19 to 27 liters (5.0 to 7.1 US gal)
{{convert|5|to|7|L|USgal|abbr=mos}}	5 liters to 7 liters (1.3 to 1.8 US gal)
{{convert|4|-|9|L|USgal|abbr=off}}	4–9 liters (1.1–2.4 US gallons)

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 values

Note: not yet operational for all units

Input	Displays as
{{convert/3 |2|x|4|x|6|m|ft}}	2×4×6 meters (6.6×13×20 ft)
{{convert/3 |60|-|70|-|80|kg|lb}}	60–70–80 kilograms (130–150–180 lb)
{{convert/3 |60|to|80|or|85|m|ft}}	60 to 80 or 85 meters (200 to 260 or 279 ft)
{{convert/3 |11|by|15|rarely|16|ft|m}}	11 by 15 rarely 16 feet (3.4 by 4.6 rarely 4.9 m)
{{convert/3 |41|to|50|to|60|F|C}}	41 to 50 to 60 °F (5 to 10 to 16 °C)
{{convert/3 |41|-|50|almost|51|F|K}}	41–50 almost 51 °F (278–283 almost 284 K)

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

Parameters

Parameters
Use UK spelling	attach |sp=uk
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 (Wikibooks:Dewikify 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. 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 (9.7).
Change "( )" to display other separators	attach |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	attach |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	attach |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	attach |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)	attach |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	attach |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.
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	attach |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 kilometers (190,000 kn) and {{convert|100|km}} gives 100 kilometers (62 mi).
Display input value with a fraction	{{convert|3/8|in|mm|3|abbr=on}} → 3⁄8 in (9.525 mm) or {{convert|11+1/4|in|cm|2|abbr=on}} → 11+1⁄4 in (28.58 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, i.e., 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, i.e.: 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 will be centered within the column.
disp=comma	The two values will be separated by a comma, for situations where the first value is already within parentheses.
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.
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}}	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

Units supported

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 unit-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 (102 km; 63 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	megameter	Mm	Mm	UK spelling: megametre	1,000,000
	kilometer	km	km	UK spelling: kilometre	1,000	km mi
	meter	m	m	UK spelling: metre	1	m ft m ftin
	centimeter	cm	cm	UK spelling: centimetre	0.01	cm in
	millimeter	mm	mm	UK spelling: millimetre	0.001	mm in
	micrometer	μm (um)	µm	UK spelling: micrometre	0.000001
	nanometer	nm	nm	UK spelling: nanometre	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		3.0856775814672×10^16
	light-year	ly	ly		9.4607304725808×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 kilometer	km2	km2	UK spelling: square kilometre	1,000,000	km2 sqmi
	square meter	m2	m2	UK spelling: square metre	1	m2 sqft
	square centimeter	cm2	cm2	UK spelling: square centimetre	0.0001	cm2 sqin
	square millimeter	mm2	mm²	UK spelling: square millimetre	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	tsubo			(400/121)
VOLUME (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/m3	combinations
SI	cubic meter	m3	m3	UK spelling: cubic metre one kiloliter	1
	cubic centimeter	cm3	cm3	UK spelling: cubic centimetre one milliliter	0.000001
		cc	cc
	cubic millimeter	mm3	mm³	UK spelling: cubic millimetre	0.000000001
non-SI metric	kiloliter	kl	kl	UK spelling: kilolitre one cubic meter	1
		kL	kL
	liter	l	l	UK spelling: litre one cubic decimeter Allows triple output units. See: full list.	0.001	l impgal l USgal l USdrygal
		L	L			L impgal L USgal L USdrygal
	centiliter	cl	cl	UK spelling: centilitre	0.00001
		cL	cL
	milliliter	ml	ml	UK spelling: millilitre one cubic centimeter	0.000001	ml impoz ml USoz
		mL	mL			mL impoz mL USoz
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	imperial barrel	impbbl	imp bbl	36 imp gal	0.16365924
	imperial bushel	impbsh	imp bsh	8 imp gal	0.03636872
		impbu	imp bu
	imperial gallon	impgal	imp gal	4.54609 liters 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 USdrygal
	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 ml impoz mL
US customary liquid measure	barrel	USbbl	UK bbl	31½ US gal used for liquids except for oil and beer (see the full list)	0.119240471196
	barrel	oilbbl	bbl	42 US gal	0.158987294928
	beer barrel	USbeerbbl (usbeerbbl)	US bbl		0.117347765304
	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
	quart	USqt	US qt	1/4 US gal or 32 US fl oz	0.000946352946
	pint	USpt	US pt	1/8 US gal or 16 US fl oz	0.000473176473
	fluid ounce	USoz (USfloz)	US fl oz	1/128 US gal	0.0000295735295625	USoz ml USoz mL USoz impoz
US customary dry measure	barrel	USdrybbl	UK bbl	105/32 US bsh	0.11562819898508
	bushel	USbsh	US bsh	2150.42 cubic inches by definition	0.03523907016688
	bushel	USbu	US bu	2150.42 cubic inches by definition	0.03523907016688
	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
	dry quart	USdryqt	US dry qt	1/32 US bsh	0.001101220942715
	dry pint	USdrypt	US dry pt	1/32 US bsh	0.0005506104713575
SPEED (Full list)
system	unit	unit- code	abbrev- iation	notes	conversion factor/(m/s)	combinations
SI	meter per second	m/s	m/s	UK spelling: metre per second	1	m/s ft/s (m/s foot/s)
non-SI metric	kilometer per hour	km/h	km/h	UK spelling: kilometre 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
	short ton-force	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
	dekajoule	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		3.6×10^15
		TW.h	TW·h
	gigawatt-hour	GWh	GWh		3.6×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		1.602176487×10^−13
	kiloelectronvolt	keV	keV		1.602176487×10^−16
	electronvolt	eV	eV		1.602176487×10^−19
	millielectronvolt	meV	meV		1.602176487×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.3558179483314003
		ftlb-f	ft·lbf
	inch-pound force	inlbf	in·lbf		0.1129848290276167
		inlb-f	in·lbf
	inch-ounce force	inozf	in·ozf		0.00706155181422604350
		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			4.1840×10^18
	gigaton of TNT	GtonTNT
	megatonne of TNT	MtTNT			4.184×10^15
	megaton of TNT	MtonTNT	Mt
	kilotonne of TNT	ktTNT			4.184×10^12
	kiloton of TNT	ktonTNT	kt
	tonne of TNT	tTNT			4,184,000,000
	ton of TNT	tonTNT
Other
	Hartree	Eh	Eh		4.35974417×10^−18
	rydberg	Ry	Ry		2.1798741×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
	liter-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
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 (9 °F) warmer
	Fahrenheit change	F-change		Used for temperature intervals instead of absolute temperatures Example:  {{convert|10|F-change|0}} colder Result: 10 °F (6 °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	metric ton	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
	dram	drachm			0.001771845195
	dram	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 meter	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 meter	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)	‎
	millimeter 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
	kilometers per liter	km/l (km/L)		Use km/L to get "km/L"		km/l mpgimp km/l mpgus
	liters per 100 kilometers	l/100 km (L/100 km)		Use L/100 km to get "L/100 km"		l/100 km mpgimp l/100 km mpgus
	liters per kilometer	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)				mpgus mpgimp
	imperial gallons per mile	impgal/mi				impgal/mi
	US gallons per mile	USgal/mi (usgal/mi)				usgal/mi
The mpgUS, USgal/mi, km/L, L/100 km and L/km variants work within combinations also.
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 kilometer	PD/km2 (PD/sqkm)		PD stands for population density, i.e. humans (inhabitants)		PD/km2 PD/sqmi
	per square kilometer	/km2 (/sqkm)		Used when the word 'inhabitants' would be inappropriate.		/km2 /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/km2
	per square mile	/sqmi		Used when the word 'inhabitants' would be inappropriate.		/sqmi /km2
	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 acre	$/acre				(none)
	dollars per hectare	$/ha				(none)
	dollars per square meter	$/m2				(none)
	dollars per square foot	$/sqft				(none)

See also

• {{Metricate}}

The above documentation is transcluded from Template:Convert/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.