ಸಹಾಯ:Convert

Template {{Convert}} is used to convert a value from one unit of measurement to another. This page provides an overview of the options available when using the template.

• Help:Convert units • Simplified list of some commonly used units.
• Help:Convert messages • Error and warning messages.

Asking questions

• Template talk:Convert • Questions on using the convert template, or discussion of any problems encountered.
• Wikipedia:Help desk • General questions.
• Module talk:Convert • Discussion concerning the convert modules.

Units

• Help:Convert units • Simplified list of some commonly used units.
• Module:Convert/documentation/conversion data/doc • Full list of units.

Quick start

By default, the name of the input unit is shown, while the output is abbreviated using the unit's symbol. If wanted, names or symbols can be used, and the output precision can be specified.

• {{convert|123.4|ft|m}} → 123.4 feet (37.6 m)
• {{convert|123.4|ft|m|abbr=on}} → 123.4 ft (37.6 m)
• {{convert|123.4|ft|m|abbr=off}} → 123.4 feet (37.6 metres)
• {{convert|123.4|ft|m|abbr=off|sp=us}} → 123.4 feet (37.6 meters)
• {{convert|123.4|ft|m|0}} → 123.4 feet (38 m)
• {{convert|123.4|ft|m|3}} → 123.4 feet (37.612 m)

To avoid overlinking, units are not normally linked, but they can be when needed.

• {{convert|12300|m2|rood|abbr=off|lk=on}} → 12,300 square metres (12.2 roods)
• {{convert|12300|m2|rood|abbr=off|lk=out}} → 12,300 square metres (12.2 roods)

A convert can be used in an adjectival phrase, and user-specified text can be inserted.

• {{convert|1500|ft|m|adj=on}} → 1,500-foot (460 m)
• {{convert|1500|ft|m|adj=mid|-long}} → 1,500-foot-long (460 m)

If no output unit is specified, a default is used.

• {{convert|123.4|ft}} → 123.4 feet (37.6 m)
• {{convert|123.4|ft|abbr=on}} → 123.4 ft (37.6 m)
• {{convert|1500|ft||adj=mid|-long}} → 1,500-foot-long (460 m)

The last example used || to explicitly show that the output unit has been omitted. If that is not done, the result is an error, and holding the mouse over the error message shows that "-long" is misinterpreted as the output unit.

• {{convert|1500|ft|adj=mid|-long}} → 1,500-foot ()

The input and outputs can be "flipped". When flipped, an option such as |lk=out means "link the right-hand side".

• {{convert|12300|m2|rood|abbr=off|lk=out}} → 12,300 square metres (12.2 roods)
• {{convert|12300|m2|rood|abbr=off|lk=out|disp=flip}} → 12.2 roods (12,300 square metres)
• {{convert|12300|m2|rood|abbr=off|lk=in|disp=flip}} → 12.2 roods (12,300 square metres)

The input value can be spelled.

• {{convert|5|mi|km|spell=in|0}} → five miles (8 km)
• {{convert|5|mi|km|spell=In|0}} → Five miles (8 km)

Ranges of values are supported.

• {{convert|3|-|6|ft}} → 3–6 feet (0.91–1.83 m)
• {{convert|3|to|6|ft|abbr=off|sp=us}} → 3 to 6 feet (0.91 to 1.83 meters)

A range can use more than two values.

• {{convert|100|x|120|x|210|mm|in}} → 100 by 120 by 210 millimetres (3.9 in × 4.7 in × 8.3 in)
• {{convert|100|xx|120|xx|210|mm|in}} → 100 × 120 × 210 millimetres (3.9 × 4.7 × 8.3 in)
• {{convert|100|x|120|x|210|mm|in|abbr=on}} → 100 mm × 120 mm × 210 mm (3.9 in × 4.7 in × 8.3 in)
• {{convert|100|*|120|*|210|mm|in|abbr=on}} → 100×120×210 mm (3.9×4.7×8.3 in)

Some input units consist of multiple components.

• {{convert|5|ft|8|in}} → 5 feet 8 inches (1.73 m)
• {{convert|11|st|3|lb|kg}} → 11 stone 3 pounds (71 kg)

An output can be a combination of several units.

• {{convert|123|nmi|km mi}} → 123 nautical miles (228 km; 142 mi)
• {{convert|123|hPa|psi inHg|abbr=on|lk=on}} → 123 hPa (1.78 psi; 3.6 inHg)

Some outputs consist of multiple units.

• {{convert|123.4|m|ydftin}} → 123.4 metres (134 yd 2 ft 10 in)
• {{convert|123.4|kg|stlb}} → 123.4 kilograms (19 st 6 lb)

Rounding

By default, the output value is rounded to adjust its precision to match that of the input. An input such as 1234 is interpreted as 1234 ± 0.5, while 1200 is interpreted as 1200 ± 50, and the output value is displayed accordingly, taking into account the scale factor used in the conversion.

If the default is not wanted, the precision of output values can be specified using:

• |N (where N is a number) to specify the number of digits to be displayed after the decimal mark (round output to N decimal places).
• |-N (where -N is a negative number) to specify the number of digits before the decimal mark that should be replaced with zero (round output to nearest 10^N).
• |sigfig=N (where N is a positive number) to specify the number of significant digits (round output to N significant figures).
• |disp=5 to round the output to the nearest multiple of 5.

Examples:

• {{convert|1234|ft|m}} → 1,234 feet (376 m)
• {{convert|1234|ft|m|2}} → 1,234 feet (376.12 m)
• {{convert|1234|ft|m|-1}} → 1,234 feet (380 m)
• {{convert|1234|ft|m|disp=5}} → 1,234 feet (375 m)
• {{convert|1234|ft|m|sigfig=2}} → 1,234 feet (380 m)
• {{convert|1234|ft|m|sigfig=4}} → 1,234 feet (376.1 m)
• {{convert|1230|ft|m}} → 1,230 feet (370 m)
• {{convert|1230|ft|m|0}} → 1,230 feet (375 m)
• {{convert|1230|ft|m|1}} → 1,230 feet (374.9 m)
• {{convert|5670|sqft}} → 5,670 square feet (527 m²)
• {{convert|5670|sqft|-2}} → 5,670 square feet (500 m²)

Spell

Use |sp=us to specify that unit names should be displayed with US spelling:

• {{convert|6|km}} → 6 kilometres (3.7 mi)
• {{convert|6|km|sp=us}} → 6 kilometers (3.7 mi)

Use |spell=in to specify that the input value should be spelled in words, or |spell=In (uppercase "I") to start with an uppercase letter:

• {{convert|5|mi|km|spell=in}} → five miles (8.0 km)
• {{convert|5|mi|km|spell=in|abbr=off|0}} → five miles (8 kilometres)
• {{convert|5|mi|km|spell=In|0}} → Five miles (8 km)
• {{convert|5|mi|km|spell=In|abbr=off|0}} → Five miles (8 kilometres)
• {{convert|2+1/4|mi|km|abbr=off|0|spell=In}} → Two and a quarter miles (4 kilometres)
• {{convert|2+1/4|mi|km|abbr=off|0|spell=In|sp=us}} → Two and a fourth miles (4 kilometers)

The input and output can be "flipped", as shown in these examples which assume that it is reasonable to round the output to the nearest integer:

• {{convert|5|mi||0|disp=flip|spell=in}} → eight kilometres (5 mi)
• {{convert|5|mi||0|disp=flip|spell=In|abbr=off}} → Eight kilometres (5 miles)

The "||" provides an empty output unit to mean "use the default".

Fractions

An input value can be specified as a fraction.

• {{convert|1/2|in|mm|1}} → 1⁄2 inch (12.7 mm)
• {{convert|1/2|in|mm|1|adj=on}} → 1⁄2-inch (12.7 mm)
• {{convert|2+1/2|in|mm|1}} → 2+1⁄2 inches (63.5 mm)
• {{convert|-2-1/4|in|mm|1}} → −2+1⁄4 inches (−57.2 mm)
• {{convert|1/2|in|mm|1|spell=in}} → one-half inch (12.7 mm)

If two slashes are used, a horizontal fraction bar is used.

• {{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)

An output can be expressed with a fraction using |frac=N where N is the denominator. For example, |frac=8 rounds the output to the nearest eighth.

• {{convert|219|mm|in|abbr=on}} → 219 mm (8.6 in)
• {{convert|219|mm|in|abbr=on|frac=2}} → 219 mm (8+1⁄2 in)
• {{convert|219|mm|in|abbr=on|frac=4}} → 219 mm (8+1⁄2 in)
• {{convert|219|mm|in|abbr=on|frac=8}} → 219 mm (8+5⁄8 in)
• {{convert|222|mm|in|abbr=on|frac=8}} → 222 mm (8+3⁄4 in)

A fraction is applied to the output unit (if there is only one), or to non-SI units (if using a combination), except that if a precision is also specified, the fraction only applies to the hand unit.

• {{convert|18.45|in|m|frac=2}} → 18.45 inches (1⁄2 m)
• {{convert|18.45|in|ft in hand cm|frac=2}} → 18.45 inches (1+1⁄2 ft; 18+1⁄2 in; 4.2+1⁄2 hands; 46.9 cm)
• {{convert|18.45|in|ft in hand cm|frac=2|1}} → 18.45 inches (1.5 ft; 18.5 in; 4.2+1⁄2 hands; 46.9 cm)

Joins

The |disp= ("display") option may be used to "join" the input and output, as shown in the following examples.

Convert	Output	Description
{{convert|2.4|m|ft}}	2.4 metres (7.9 ft)	default
{{convert|2.4|m|ft|disp=b}}	2.4 metres (7.9 ft)	brackets (same as default)
{{convert|2.4|m|ft|disp=sqbr}}	2.4 metres [7.9 ft]	square brackets
{{convert|2.4|m|ft|disp=or}}	2.4 metres or 7.9 feet	or
{{convert|2.4|m|ft|disp=comma}}	2.4 metres, 7.9 ft	comma
{{convert|2.4|m|ft|disp=slash}}	2.4 metres (7.9 ft)	slash
{{convert|2.4|m|ft|disp=slash|abbr=on}}	2.4 m (7.9 ft)	slash (not spaced)
{{convert|2.4|m|ft|disp=br}}	2.4 metres 7.9 feet	"<br />", line break

Ranges

A range of values can be specified, as shown in the following examples.

Convert	Output
{{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|and|6|ft}}	3 and 6 feet (0.91 and 1.83 m)
{{convert|3|or|6|ft}}	3 or 6 feet (0.91 or 1.83 m)
{{convert|3|to|6|ft}}	3 to 6 feet (0.91 to 1.83 m)
{{convert|3|to(-)|6|ft}}	3 to 6 feet (0.91–1.83 m)
{{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|by|6|ft}}	3 by 6 feet (0.91 by 1.83 m)
{{convert|3|x|6|ft}}	3 by 6 feet (0.91 m × 1.83 m)
{{convert|3|xx|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)
{{convert|3|, and|6|ft}}	3, and 6 feet (0.91, and 1.83 m)
{{convert|3|, or|6|ft}}	3, or 6 feet (0.91, or 1.83 m)

The following ranges provide different output when units are abbreviated.

Convert	Output
{{convert|3|to(-)|6|ft|abbr=on}}	3 to 6 ft (0.91–1.83 m)
{{convert|3|x|6|ft|abbr=on}}	3 ft × 6 ft (0.91 m × 1.83 m)

Extra words

Some options provide text that is included in the output, as shown in the following examples.

Convert	Output	Description
{{convert|4|ft||adj=mid|-long}}	4-foot-long (1.2 m)	adjectival with mid-text between input and output
{{convert|40|acre||adj=pre|planted}}	40 planted acres (16 ha)	text before the input unit
{{convert|4|m||disp=preunit|+ }}	4+ metres (13+ ft)	same text before the input and output units
{{convert|4|m||disp=preunit|+ |or more }}	4+ metres (13 or more ft)	different text before the input and output units
{{convert|20|impfloz||disp=x|, approximately }}	20 imperial fluid ounces, approximately 570 ml; 19 US fl oz	text before the output (replaces the join)
{{convert|100|m||disp=x|/day (|/day)}}	100 metres/day (330 ft/day)	text before and after the output (replaces the join)

In each of the above examples, "||" provides an empty output unit which causes the default output to be used. An output unit, possibly empty, must be specified to avoid the template interpreting the extra text as the output unit. For example, using {{convert|4|ft|adj=mid|-long}} has the same effect as using {{convert|4|ft|-long|adj=mid}}, namely that an error would occur because "-long" would be used as the output unit. The following illustrates the error (hover the mouse over the error text to see that the problem is due to "-long" ) and how it may be avoided.

• {{convert|4|ft|adj=mid|-long}} → 4-foot ()
• {{convert|4|ft||adj=mid|-long}} → 4-foot-long (1.2 m)
• {{convert|4|ft| |adj=mid|-long}} → 4-foot-long (1.2 m)
• {{convert|4|ft|m|adj=mid|-long}} → 4-foot-long (1.2 m)

Displaying parts of a convert

The following examples show how to display only some of the result of a convert.

Convert	Output	Description
{{convert|2|cuyd}}	2 cubic yards (1.5 m3)	normal convert
{{convert|2|cuyd|disp=unit}}	cubic yards	input unit
{{convert|2|cuyd|disp=unit|adj=on}}	cubic-yard	input unit, adjectival (hyphenated)
{{convert|2|cuyd|disp=unit2}}	m3	output unit (symbol)
{{convert|2|cuyd|disp=unit2|abbr=off}}	cubic metres	output unit (name)
{{convert|2|cuyd|disp=unit2|abbr=off|sp=us}}	cubic meters	output unit (name, US spelling)
{{convert|2|cuyd|abbr=values}}	2 (1.5)	input and output values
{{convert|2|cuyd|disp=number}}	1.5	output value
{{convert|2|cuyd|disp=out}}	1.5 m3	output value and unit
{{convert|9+5/8|cuyd|cuyd|disp=number|frac=8}}	9+5⁄8	input value
{{convert|9+5/8|cuyd|cuyd|abbr=off|disp=out|frac=8}}	9+5⁄8 cubic yards	input value and unit

Tables

The following parameters are intended for use in tables.

Parameter	Description
|disp=table	for a table cell with align="right"
|disp=tablecen	for a table cell with align="center"
|sortable=on	output a numeric hidden sort field for a sortable table

The following shows the wikitext output by some example converts.

Convert	Resulting wikitext
{{convert|47.5|kg|lb}}	47.5 kilograms (105 lb)
{{convert|47.5|kg|lb|disp=table}}	align="right"|47.5 |align="right"|105
{{convert|47.5|kg|lb|disp=tablecen}}	align="center"|47.5 |align="center"|105
{{convert|47.5|kg|lb|sortable=on}}	<span style="display:none">7001475000000000000</span>47.5 kilograms (105 lb)

Fixed table

This wikitext:

{|class="wikitable"
! align=right, rowspan="2" |
!colspan="2"| Length
!colspan="2"| Weight
|- style="vertical-align:bottom;"
!metres !!ft in !!kg !!lb
|-
! Lorem ipsum
| {{convert|28.1|m|ftin|disp=table}}
| {{convert|47.5|kg|lb|disp=table}}
|-
! Dolor sit amet
| {{convert|9.9|m|ftin|disp=table}}
| {{convert|74.1|kg|lb|disp=table}}
|-
! Consectetur
| {{convert|38.2|m|ftin|disp=table}}
| {{convert|31.5|kg|lb|disp=table}}
|-
! Adipisicing elit
| {{convert|18.7|m|ftin|disp=table}}
| {{convert|52.7|kg|lb|disp=table}}
|}

produces this table:

	Length		Weight
	metres	ft in	kg	lb
Lorem ipsum	28.1	92 ft 2 in	47.5	105
Dolor sit amet	9.9	32 ft 6 in	74.1	163
Consectetur	38.2	125 ft 4 in	31.5	69
Adipisicing elit	18.7	61 ft 4 in	52.7	116

Sortable table

This wikitext:

{|class="wikitable sortable"
! align=right, rowspan="2" |
!colspan="2"| Length
!colspan="2"| Weight
|- style="vertical-align:bottom;"
!metres !!ft in !!kg !!lb
|-
! Lorem ipsum
| {{convert|28.1|m|ftin|disp=table|sortable=on}}
| {{convert|47.5|kg|lb|disp=table|sortable=on}}
|-
! Dolor sit amet
| {{convert|9.9|m|ftin|disp=table|sortable=on}}
| {{convert|74.1|kg|lb|disp=table|sortable=on}}
|-
! Consectetur
| {{convert|38.2|m|ftin|disp=table|sortable=on}}
| {{convert|31.5|kg|lb|disp=table|sortable=on}}
|-
! Adipisicing elit
| {{convert|18.7|m|ftin|disp=table|sortable=on}}
| {{convert|52.7|kg|lb|disp=table|sortable=on}}
|}

produces this table:

	Length		Weight
	metres	ft in	kg	lb
Lorem ipsum	28.1	92 ft 2 in	47.5	105
Dolor sit amet	9.9	32 ft 6 in	74.1	163
Consectetur	38.2	125 ft 4 in	31.5	69
Adipisicing elit	18.7	61 ft 4 in	52.7	116

Options

The following options are available.

Option	Description
|abbr=comma	No comma in input or output numbers.
|abbr=in	Use symbol for LHS unit.
|abbr=off	Use name for all units.
|abbr=on	Use symbol for all units.
|abbr=out	Use symbol for RHS unit (default).
|abbr=values	Show only input and output numbers, not units.
|abbr=~	Show input unit symbol as well as name.
|adj=1	Unit name is singular when value is 1 or less, but not zero.
|adj=flip	Reverse order of input/output.
|adj=j	Join value and unit name using " " instead of a space.
|adj=mid	Same as adj=on with user-specified text after input unit.
|adj=nocomma	No comma in input or output numbers.
|adj=on	Unit name is singular and hyphenated.
|adj=pre	User-specified text before input unit.
|adj=ri1	Round input with precision 1.
|adj=ri2	Round input with precision 2.
|adj=ri3	Round input with precision 3.
|disp=/	Join input/output using "/".
|disp=2	Display only output value and symbol/name.
|disp=5	Round output value to nearest 5.
|disp=b	Join input/output using "(...)".
|disp=br	Join input/output using "<br/>".
|disp=comma	Join input/output using ",".
|disp=flip	Reverse order of input/output.
|disp=flip5	Same as disp=flip with disp=5.
|disp=nocomma	No comma in input or output numbers.
|disp=number	Display output value only.
|disp=or	Join input/output using "or".
|disp=out	Same as disp=2.
|disp=output number only	Same as disp=number.
|disp=output only	Same as disp=2.
|disp=preunit	User-specified text before input and output units.
|disp=s	Same as disp=/.
|disp=slash	Same as disp=/.
|disp=sqbr	Join input/output using "[...]".
|disp=table	Output is suitable for a table cell with align="right".
|disp=tablecen	Output is suitable for a table cell with align="center".
|disp=u2	Display output symbol/name (not input; not output value).
|disp=unit	Display input symbol/name (not output; not input value).
|disp=unit2	Same as disp=u2.
|disp=x	Join input/output using user-specified text.
|comma=5	Only use comma grouping if 5 or more digits.
|comma=gaps	Use gaps, not comma, to separate groups of digits.
|comma=gaps5	Use gaps, but only if 5 or more digits.
|debug=yes	Make the normally hidden sort key visible.
|lk=in	Link LHS unit name or symbol.
|lk=on	Link all unit names or symbols (but not twice for the same unit).
|lk=out	Link RHS unit name or symbol.
|sigfig=N	Round output value to N significant figures (N is a positive integer).
|sortable=on	Output numeric hidden sort field for use in a sortable table.
|sp=us	Use U.S. spelling (like "meter" instead of default "metre").
|spell=in	Spell input value in words.
|spell=In	Spell input value in words with first letter uppercase.

Examples of number grouping:

• {{convert|1234|m|ft}} → 1,234 metres (4,049 ft)
• {{convert|1234|m|ft|comma=5}} → 1234 metres (4049 ft)
• {{convert|12345|m|ft|comma=5}} → 12,345 metres (40,502 ft)
• {{convert|1234|m|ft|comma=gaps}} → 1234 metres (4049 ft)
• {{convert|1234|m|ft|comma=gaps5}} → 1,234 metres (4,049 ft)
• {{convert|123,456,789|m|ft|comma=gaps5}} → 123,456,789 metres (405,041,959 ft)

Examples of spelling input values:

• {{convert|10|mi|km|spell=in}} → ten miles (16 km)
• {{convert|10|mi|km|spell=In}} → Ten miles (16 km)
• {{convert|1/3|mi|km|adj=on|spell=in}} → one-third-mile (0.54 km)

Differences from templates previously used

Before December 2013, {{Convert}} was implemented by a series of templates, not a module. Following are some differences between the new and old convert implementations.

• Using {{subst:convert|...}} works with the module.
• The module checks unit types and displays an error message if a mismatch occurs.
• The module does not have a problem with template loops, and will allow pointless conversions like {{convert|123|m|m}}.
• Ranges and all options, including disp=flip, should work with all units.
• Scaled units like e6USgal are not predefined. With some exceptions, all units accept prefixes e3, e6, e9, e12, e15.
• The module uses an empty unit code rather than 0 to mean "use the default unit", as in {{convert|4|ft||adj=mid|-long}} (it is also possible to use {{convert|4|ft|0|adj=mid|-long}}, but that sets the output precision to zero).
• The functionality of {{convert/3}} and {{convert/4}} is handled by the module, except that the module does not support arbitrary text to separate items in a range. Furthermore, the predefined separator words such as "by" and "to" behave in exactly the same manner as they do for standard converts, so a conversion like {{convert/3|2|x|4|x|6|m|ft}} would need to use the new * separator rather than x to produce exactly the same output with the module.

Limitations

This is a list of features that the module may be expected to support, but which will not work.

Composite units cannot be used in a range:

• {{convert|2|ft|6|in|to|3|ft|9|in}} → 2 feet 6 inches ()

If an expression is wanted, it has to use {{#expr:...}}:

• {{convert|3*12|ft|mm}} → 3×12 feet (910×3,660 mm)
• {{convert|{{#expr:3*12}}|ft|mm}} → 36 feet (11,000 mm)