مساعدة:Convert

قالب:Wikipedia how to 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 أقدام (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 أقدام (37.6 متر)
{{convert|123.4|ft|m|abbr=off|sp=us}} → 123.4 أقدام (37.6 متر)
{{convert|123.4|ft|m|0}} → 123.4 أقدام (38 m)
{{convert|123.4|ft|m|3}} → 123.4 أقدام (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 متر مربع (12.2 rood)
{{convert|12300|m2|rood|abbr=off|lk=out}} → 12،300 متر مربع (12.2 rood)

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

{{convert|1500|ft|m|adj=on}} → 1،500-قدم (460 m)
{{convert|1500|ft|m|adj=mid|-long}} → 1،500-قدم-long (460 m)

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

{{convert|123.4|ft}} → 123.4 أقدام (37.6 m)
{{convert|123.4|ft|abbr=on}} → 123.4 ft (37.6 m)
{{convert|1500|ft||adj=mid|-long}} → 1،500-قدم-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-قدم (^{[convert: unknown unit]})

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 متر مربع (12.2 rood)
{{convert|12300|m2|rood|abbr=off|lk=out|disp=flip}} → 12.2 rood (12،300 متر مربع)
{{convert|12300|m2|rood|abbr=off|lk=in|disp=flip}} → 12.2 rood (12،300 متر مربع)

The input value can be spelled.

{{convert|5|mi|km|spell=in|0}} → خمسة ميل (8 km)
{{convert|5|mi|km|spell=In|0}} → خمسة ميل (8 km)

Ranges of values are supported.

{{convert|3|-|6|ft}} → 3–6 أقدام (0.91–1.83 m)
{{convert|3|to|6|ft|abbr=off|sp=us}} → 3 إلى 6 أقدام (0.91 إلى 1.83 متر)

A range can use more than two values.

{{convert|100|x|120|x|210|mm|in}} → 100 في 120 في 210 ميليمتر (3.9 in × 4.7 in × 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|by|120|by|210|mm|in}} → 100 في 120 في 210 ميليمتر (3.9 في 4.7 في 8.3 in)

Some input units consist of multiple components.

{{convert|5|ft|8|in}} → 5 أقدام 8 بوصات (1.73 m)
{{convert|11|st|3|lb|kg}} → 11 ستون 3 رطل (71 kg)

An output can be a combination of several units.

{{convert|123|nmi|km mi}} → 123 ميل بحري (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 متر (134 yd 2 ft 10 in)
{{convert|123.4|kg|stlb}} → 123.4 كيلوغرام (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).
|round=5 to round the output to the nearest multiple of 5.

Examples:

{{convert|1234|ft|m}} → 1،234 أقدام (376 m)
{{convert|1234|ft|m|2}} → 1،234 أقدام (376.12 m)
{{convert|1234|ft|m|-1}} → 1،234 أقدام (380 m)
{{convert|1234|ft|m|round=5}} → 1،234 أقدام (375 m)
{{convert|1234|ft|m|sigfig=2}} → 1،234 أقدام (380 m)
{{convert|1234|ft|m|sigfig=4}} → 1،234 أقدام (376.1 m)
{{convert|1230|ft|m}} → 1،230 أقدام (370 m)
{{convert|1230|ft|m|0}} → 1،230 أقدام (375 m)
{{convert|1230|ft|m|1}} → 1،230 أقدام (374.9 m)
{{convert|5670|sqft}} → 5،670 أقدام مربعة (527 m²)
{{convert|5670|sqft|-2}} → 5،670 أقدام مربعة (500 m²)

Spell

Use US (en-US) spelling for unit names

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

{{convert|6|km}} → 6 كيلومتر (3.7 mi)
{{convert|6|km|sp=us}} → 6 كيلومتر (3.7 mi)

Spell out numbers in words

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}} → خمسة ميل (8.0 km)
{{convert|5|mi|km|spell=in|abbr=off|0}} → خمسة ميل (8 كيلومتر)
{{convert|5|mi|km|spell=In|0}} → خمسة ميل (8 km)
{{convert|5|mi|km|spell=In|abbr=off|0}} → خمسة ميل (8 كيلومتر)
{{convert|2+1/4|mi|km|abbr=off|0|spell=In}} → اثنان وواحد من أربعة ميل (4 كيلومتر)
{{convert|2+1/4|mi|km|abbr=off|0|spell=In|sp=us}} → اثنان وواحد من أربعة ميل (4 كيلومتر)

The input and output can be "flipped", as shown in these examples. Logically, the resulting first number is spelled:

{{convert|5|mi||0|disp=flip|spell=in}} → ثمانية كيلومتر (5 mi)
{{convert|5|mi||0|disp=flip|spell=In|abbr=off}} → ثمانية كيلومتر (5 ميل)

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

Both input and output values can be spelled:

{{convert|5|mi|m|-2|spell=on|sp=us|abbr=off}} → خمسة ميل (ثمانية ألف متر)
{{convert|5|mi|m|-2|spell=On|sp=us|abbr=off}} → خمسة ميل (ثمانية ألف متر)

Thousands separator

In input, a comma for thousands separator is accepted. In output, by default, the thousands separator is the comma:

{{convert|1234567|m|ft}} → 1،234،567 متر (4،050،417 ft)
{{convert|1,234,567|m|ft}} → 1،234،567 متر (4،050،417 ft)

Set |comma=off to remove any thousands separator in the result:

{{convert|1,234,567|m|ft|comma=off}} → 1،234،567 متر (4،050،417 ft)^*

Use |comma=gaps to set thousands grouping by gap (<space>):

{{convert|1234567|m|ft}} → 1،234،567 متر (4،050،417 ft) (To compare, default)
{{convert|1234567|m|ft|comma=gaps}} → 1234567 متر (4050417 ft)

Setting |comma=5 or |comma=gaps5 will only add the separator only when the number of digits is 5 or more:

{{convert|1234|m|ft}} → 1،234 متر (4،049 ft) (To compare, default)
{{convert|1234|m|ft|comma=5}} → 1234 متر (4049 ft)
{{convert|1234567|m|ft|comma=5}} → 1،234،567 متر (4،050،417 ft)
{{convert|1234|m|ft|comma=gaps5}} → 1،234 متر (4،049 ft)^*
{{convert|1234567|m|ft|comma=gaps5}} → 1،234،567 متر (4،050،417 ft)^*

In input, gaps are not accepted.

Fractions

An input value can be specified as a fraction.

{{convert|1/2|in|mm|1}} → 1⁄2 بوصة (12.7 mm)
{{convert|1/2|in|mm|1|adj=on}} → 1⁄2-بوصة (12.7 mm)
{{convert|2+1/2|in|mm|1}} → 2+1⁄2 بوصات (63.5 mm)
{{convert|-2-1/4|in|mm|1}} → −2+1⁄4 بوصات (−57.2 mm)
{{convert|1/2|in|mm|1|spell=in}} → واحد من اثنان بوصة (12.7 mm)

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

{{convert|1//2|in|mm|1}} → 1/2 بوصة (12.7 mm)
{{convert|2+1//2|in|mm|1}} → 2+1/2 بوصات (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 بوصات (1⁄2 m)
{{convert|18.45|in|ft in hand cm|frac=2}} → 18.45 بوصات (1+1⁄2 ft; 18+1⁄2 in; 4.2+1⁄2 hand; 46.9 cm)
{{convert|18.45|in|ft in hand cm|frac=2|1}} → 18.45 بوصات (1.5 ft; 18.5 in; 4.2+1⁄2 hand; 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 متر (7.9 ft)	default
`{{convert\|2.4\|m\|ft\|disp=b}}`	2.4 متر (7.9 ft)	brackets (same as default)
`{{convert\|2.4\|m\|ft\|disp=sqbr}}`	2.4 متر [7.9 ft]	square brackets
`{{convert\|2.4\|m\|ft\|disp=or}}`	2.4 متر أو 7.9 أقدام	or
`{{convert\|2.4\|m\|ft\|disp=comma}}`	2.4 متر، 7.9 ft	comma
`{{convert\|2.4\|m\|ft\|disp=br}}`	2.4 متر 7.9 أقدام	"<br />", line break

Ranges

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

v t e Range separators in {{convert}}
Separator	Convert	Result	Notes
`-`	`{{convert\|3\|-\|6\|ft}}`	3–6 أقدام (0.91–1.83 m)	Input can be hyphen (-) or en dash (–), output uses en dash
`–` `–` (en dash)	`{{convert\|3\|–\|6\|ft}}`	3–6 أقدام (0.91–1.83 m)	Input can be hyphen (-) or en dash (–), output uses en dash
`and`	`{{convert\|3\|and\|6\|ft}}`	3 و 6 أقدام (0.91 و 1.83 m)
`&`	`{{convert\|3\|&\|6\|ft}}`	3 &^{[convert: unknown unit]}	Same as `and`
`and(-)`	`{{convert\|3\|and(-)\|6\|ft}}`	3 و 6 أقدام (0.91–1.83 m)	`\|abbr=on` abbreviates the first unit
`and(-)\|abbr=on`	`{{convert\|3\|and(-)\|6\|ft\|abbr=on}}`	3 و 6 ft (0.91–1.83 m)	`\|abbr=on` abbreviates the first unit
`or`	`{{convert\|3\|or\|6\|ft}}`	3 أو 6 أقدام (0.91 أو 1.83 m)
`to`	`{{convert\|3\|to\|6\|ft}}`	3 إلى 6 أقدام (0.91 إلى 1.83 m)
`to(-)`	`{{convert\|3\|to(-)\|6\|ft}}`	3 to 6 أقدام (0.91–1.83 m)	`\|abbr=on` abbreviates the first unit
`to(-)\|abbr=on`	`{{convert\|3\|to(-)\|6\|ft\|abbr=on}}`	3 to 6 ft (0.91–1.83 m)	`\|abbr=on` abbreviates the first unit
`to about`	`{{convert\|3\|to about\|6\|ft}}`	3 إلى حوالي 6 أقدام (0.91 إلى حوالي 1.83 m)
`+/-`	`{{convert\|3\|+/-\|6\|ft}}`	3 ± 6 أقدام (0.91 ± 1.83 m)
`±` `±`	`{{convert\|3\|±\|6\|ft}}`	3 ± 6 أقدام (0.91 ± 1.83 m)
`+`	`{{convert\|3\|+\|6\|ft}}`	3 + 6 أقدام (0.91 + 1.83 m)
`,`	`{{convert\|3\|,\|6\|ft}}`	3, 6 أقدام (0.91, 1.83 m)
`, and`	`{{convert\|3\|, and\|6\|ft}}`	3، و 6 أقدام (0.91، و 1.83 m)
`, or`	`{{convert\|3\|, or\|6\|ft}}`	3، أو 6 أقدام (0.91، أو 1.83 m)
`by`	`{{convert\|3\|by\|6\|ft}}`	3 في 6 أقدام (0.91 في 1.83 m)
`x`	`{{convert\|3\|x\|6\|ft}}`	3 في 6 أقدام (0.91 m × 1.83 m)	Scientific notation. `\|abbr=on` abbreviates the first unit
`×` `×`	`{{convert\|3\|×\|6\|ft}}`	3 في 6 أقدام (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

Ranges can use more than two values.

Convert	Output
`{{convert\|3\|x\|4\|x\|24\|in}}`	3 في 4 في 24 بوصات (76 mm × 102 mm × 610 mm)
`{{convert\|3\|x\|4\|to\|6+1/2\|x\|8+3/4\|in}}`	3 في 4 إلى 6+1⁄2 في 8+3⁄4 بوصات (76 mm × 102 mm إلى 165 mm × 222 mm)

Ranges can be specified in the first parameter.

Convert	Output
`{{convert\|3.2-7.5\|ha}}`	3.2–7.5 هكتار (7.9–18.5 acre)
`{{convert\|3x4x24\|in}}`	3 في 4 في 24 بوصات (76 mm × 102 mm × 610 mm)

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-قدم-long (1.2 m)	Adjectival with mid-text between input and output (sets `\|adj=on`)
`{{convert\|40\|acre\|\|adj=pre\|planted}}`	40 planted acre (16 ha)	Text before the input unit
`{{convert\|4\|m\|\|disp=preunit\|+ }}`	4+ متر (13+ ft)	Same text before the input and output units
`{{convert\|4\|m\|\|disp=preunit\|+ \|or more }}`	4+ متر (13 or more ft)	Different text before the input and output units
`{{convert\|20\|impfloz\|\|disp=x\|, approximately }}`	20 imperial fluid ounce, approximately 570 ml; 19 US fl oz	Text before the output (replaces the join)
`{{convert\|100\|m\|\|disp=x\|/day (\|/day)}}`	100 متر/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-قدم (^{[convert: unknown unit]})
{{convert|4|ft||adj=mid|-long}} → 4-قدم-long (1.2 m)
{{convert|4|ft| |adj=mid|-long}} → 4-قدم-long (1.2 m)
{{convert|4|ft|m|adj=mid|-long}} → 4-قدم-long (1.2 m)

Displaying parts of a conversion

The following examples show how to display only some part of the output result.

Convert	Output	Description
`{{convert\|2\|cuyd\|m3}}`	2 ياردة مكعبة (1.5 m³)	normal convert
`{{convert\|2\|cuyd\|m3\|abbr=values}}`	2 (1.5)	input and output values
`{{convert\|2\|cuyd\|m3\|disp=unit}}`	ياردة مكعبة	input unit
`{{convert\|2\|cuyd\|m3\|disp=unit\|adj=on}}`	ياردة-مكعبة	input unit, adjectival (hyphenated)
`{{convert\|2\|cuyd\|cuyd\|0\|disp=out\|abbr=off}}`	2 ياردة مكعبة	input (workaround)
`{{convert\|2\|cuyd\|m3\|disp=unit2}}`	m³	output unit (symbol)
`{{convert\|2\|cuyd\|m3\|disp=unit2\|abbr=off}}`	متر مكعب	output unit (name)
`{{convert\|2\|cuyd\|m3\|disp=number}}`	1.5	output value
`{{convert\|2\|cuyd\|m3\|disp=out}}`	1.5 m³	output value and unit
`{{convert\|2\|cuyd\|m3\|abbr=off\|disp=out}}`	1.5 متر مكعب	output value and unit

Flipping the order of output

To invert the order of measurements, simply use |order=flip

{{convert|10|km|mi}} → 10 كيلومتر (6.2 mi) (default)
{{convert|10|km|mi|order=flip}} → 6.2 ميل (10 km)

Wrapping and line breaking

Convert uses the regular space (" ") and non-breaking space (  which shows: " ") to control line-breaking (also called wrapping/nowrapping).

Wrapping is possible where a space (" ") is used. Prevent wrapping is enforced by using the non-breaking space, that ties and keeps text elements together.

3 feet may break after "3"

3 ft, or 3_ft, will not break after "3"

In the examples below, an   is shown as "_" (red underscore): "3_ft".

A line break (<br/>) forces a newline (line break), and so overrules any nowrap setting at that point.

Within a measurement (value+unit)

The separator between the value and the unit can be a space or a nonbreaking space ( ):

When a unit is abbreviated (symbol is shown), the separator is  .

{{convert|12|m|ft|abbr=on}} → 12_m (39_ft)

When a unit is not abbreviated (name is shown), the separator is a space.

{{convert|12|m|ft}} → 12 متر (39_ft)

This can be set (overruled) to be   by |adj=j (for 'join').

{{convert|12|m|ft|adj=j}} → 12 متر (39_ft)^*

Some units do not have a symbol and always use a space (such as acre).

{{convert|3|acre|m2|abbr=on}} → 3 acre (12،000_m²)

Except, option |adj=j ("join") forces the separator to be  .

{{convert|3|acre|m2|adj=j}} → 3 acre (12،000_m²)^*

Except,   is always used when a measurement is in multiple units.

{{convert|1|ft|6|in|cm}} → 1_قدم 6_بوصات (46_cm)

{{convert|2|m|ftin}} → 2 متر (6_ft 7_in)

Except, if option |adj=on is used and the unit is not abbreviated, the separator is a hyphen ("-").

{{convert|2|m|ftin|adj=on}} → 2-متر (6_ft 7_in)

When the name of a number is used,   is used as the separator between the value and the name. For example, a measurement spelled as "12 million metres" has   before "million" and a space afterwards.

{{convert|12|e6m}} → 12_million متر (39،000،000_ft)

Between measurements

A space is used as the separator in a join between the first and second measurement.

{{convert|3|ft|m}} → 3 أقدام (0.91_m)

Except for the special case before "[" :

{{convert|12|in|cm|disp=sqbr|abbr=on}} → 12_in_[30_cm] (  before "[")

Multiple output measurements (by listing units) always use a space between measurements ("; " has a space after ";").

{{convert|2|acre|m2 sqft ha}} → 2 acre (8،100_m²; 87،000_sq_ft; 0.81_ha)

Between components of a measurement (e.g., in a range; between foot–inch)

A measurement in multiple units always uses a space between components ("1 foot 6 inches" has   before the unit names, but a space after "foot").

{{convert|1|ft|6|in|cm}} → 1_قدم 6_بوصات (46_cm)

In a range, spaces are generally used to separate items. For example, "to" and "or" have a space before and after in the following.

{{convert|12|to|20|in|cm}} → 12 إلى 20 بوصات (30 إلى 51_cm)

{{convert|12|or|20|in|cm}} → 12 أو 20 بوصات (30 أو 51_cm)

The ranges +/- and , always use  :

{{convert|12|+/-|2|in|cm}} → 12_±_2 بوصات (30.5_±_5.1_cm)

{{convert|12|,|20|in|cm}} → 12,_20 بوصات (30,_51_cm)

The "to-" range (same as "to(-)") is an exception. When a unit is not abbreviated, "to" has   before and a space after.

{{convert|12|to-|20|in|cm}} → 12 to-^{[convert: unknown unit]}

The "x" range is an exception. When a unit is abbreviated, "×" has a space before and   after.

{{convert|12|x|20|in|cm}} → 12 في 20 بوصات (30_cm ×_51_cm)

Overrule by setting a line break

Parameter |disp=br adds a forced line break (<br/>) between measurements; brackets are omitted.

{{convert|12|m|ft|disp=br}} → 12 متر
39 أقدام

Preview wikicode

To see the wikicode result of the convert template: put your {{convert|...}} code into Special:ExpandTemplates and then preview by clicking OK.

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

Units in singular or plural

Unit symbols are always singular. Unit names can be singular or plural. A unit is singular when the number is exactly +1:

{{convert|0.5|ft|m|abbr=off}} → 0.5 أقدام (0.15 متر)
{{convert|1|ft|m|abbr=off}} → 1 قدم (0.30 متر)
{{convert|2|ft|m|abbr=off}} → 2 أقدام (0.61 متر)

Note: as of November 2014, in certain conditions this topic can behave unexpected (bug).

Setting |adj=1 makes these values singular: (−1 <= v and v < 0) or (0 < v and v <= 1)

{{convert|2|ft|m|adj=1|abbr=off}} → 2 أقدام (0.61 متر)^*
{{convert|1|ft|m|adj=1|abbr=off}} → 1 قدم (0.30 متر)^*
{{convert|0.5|ft|m|adj=1|abbr=off}} → 0.5 أقدام (0.15 متر)^*
{{convert|0|ft|m|adj=1|abbr=off}} → 0 أقدام (0 متر)^*
{{convert|-0.5|ft|m|adj=1|abbr=off}} → −0.5 أقدام (−0.15 متر)^*
{{convert|-1|ft|m|adj=1|abbr=off}} → −1 قدم (−0.30 متر)^*
{{convert|-2|ft|m|adj=1|abbr=off}} → −2 أقدام (−0.61 متر)^*

Parameter list

v t e Parameter options for {{convert}}
Parameter	Value	Description	Note
`\|abbr=in`	`in`	Use symbol for first (left-hand side) unit	Unit display
`\|abbr=off`	`off`	Use name for all units	Unit display
`\|abbr=none`	`none`	Use name for all units	Unit display
`\|abbr=on`	`on`	Use symbol for all units	Unit display
`\|abbr=out`	`out`	Use symbol for right-hand side unit (default)	Unit display
`\|abbr=unit`	`unit`	Use symbol for all units when using scientific notation	Unit display
`\|abbr=values`	`values`	Omit both the input and output units: show only the numbers	Unit display
`\|abbr=~`	`~`	Shows both unit name and symbol	Unit display
`\|adj=mid\|…`	`mid`	User-specified text after the input unit; sets `adj=on` (adjective). Expects 1 unnamed parameter.	Word adding, adjective
`\|adj=on`	`on`	Unit name is adjective (singular and hyphenated)	Grammar, adjective
`\|adj=pre\|…`	`pre`	User-specified text before input unit. Expects 1 unnamed parameter.	Word adding
`\|adj=ri0`	`ri0`	Round input with precision 0	Input precision
`\|adj=ri1`	`ri1`	Round input with precision 1	Input precision
`\|adj=ri2`	`ri2`	Round input with precision 2	Input precision
`\|adj=ri3`	`ri3`	Round input with precision 3	Input precision
`\|comma=5`	`5`	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=off`	`off`	No thousands separator	Number format
`\|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`	Display output number only	Parts only
`\|disp=out`	`out`	Display only output number and name/symbol	Parts only
`\|disp=output only`	`output only`	Display only output number and name/symbol	Parts only
`\|disp=preunit\|…[\|…]`	`preunit`	Text to be inserted after value and before units, for both input and output, with optionally different text for output. Expects 1 or 2 unnamed parameters.	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
`\|frac=N`	`N`	Show imperial number in fractions, denominator=N	Number format, fraction
`\|input=P2048`	`P2048` (e.g.)	Reads and converts Wikidata property	Inside template
`\|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
`\|order=out`	`out`	Displays output units in the order entered, skipping input unit	Order
`\|qid=Q1056131`	`Q1056131` (e.g.)	Reads Wikidata property from Wikidata item	Inside template; testing
`\|qual=Q613628`	`Q613628` (e.g.)	Qualify Wikidata property
`\|round=5`	`5`	Rounds calculation to the nearest multiple of 5	Output precision
`\|round=25`	`25`	Rounds calculation to the nearest multiple of 25	Output precision
`\|round=each`	`each`	In a range, each number is rounded by the default rounding	Output precision
`\|sigfig=N`	`N`	Round output number to N significant figures (N is a positive integer)	Output precision
`\|sortable=on`	`on`	Adds invisible sort key	Table sort
`\|sp=us`	`us`	Use U.S. spelling ("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
`\|disp=flip`	`flip`	Deprecated. Use \|order=flip	Order
`\|sing=`		Deprecated. Use \|adj=	Plurals

Complicated grammar

This example is from article Fort McHenry:

The American defenders had 18-, 24- and 32-pounder (8, 11 and 15 kg) cannons.

This result is not possible straightforward by using {{convert}}. However, it can be made in three steps. Short: step 1: get the values right using {{convert}}, step 2: make them into hardcoded text, step 3: edit text into correct spelling and grammar. Long:

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 رطل (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 {{subst:convert|18|,|24|,|32|lb|kg|0}} cannons


As a check: the preview result should show the conversion correct, with the values 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.

You can change the text as needed. The template {{convert|...}} itself has disappeared. The edit screen text is:
had 18,&nbsp;24,&nbsp;32 pounds (8,&nbsp;11,&nbsp;15&nbsp;kg) cannons
You can edit this text to add the grammar:
had 18-,_24-_and_32-pounder (8,&nbsp;11_and_15&nbsp;kg) cannons 
After saving your edit, it shows:
→ "had 18-, 24- and 32-pounder (8, 11 and 15 kg) cannons".

Other options are (all replacing step 2 in the above):

B. Save the primary {{convert}} conversion, and then copy-paste the values from the plain read page into edit-page.
C. Put the {{convert|...}} code in Special:ExpandTemplates, and paste the result from there into the edit screen.

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.
Ranges and all options, including order=flip, work with all units.
Scaled units like e6USgal are not predefined. With some exceptions, all standard (simple) 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||abbr=on}}

Note that writing {{convert|4|ft|0|abbr=on}} 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.
The module does not have a problem with template loops, and will allow pointless conversions like {{convert|123|m|m}}.

DeprecatedThis list: view • talk • edit

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=j is deprecated. No need to use NBSP before full unit name. See MOS
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 deprecated. 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
sing= is deprecated in any situation. Use adj= 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

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 أقدام 6 بوصات (^{[convert: unknown unit]})^*

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

{{convert|3*12|ft|mm}} → 3×12 أقدام (910×3،660 mm)
{{convert|{{#expr:3*12}}|ft|mm}} → 36 أقدام (11،000 mm)


v
t
e
صفحات مساعدة المعرفة
تفضّل بزيارة بوابة المشاركة إذا كنت محرّرًا جديدًا لتطّلع على صفحات مساعدةٍ تفاعليّة، أو زُر ميدان المساعدة لطرح أسئلتك ليُجيب عليها متطوّعون.
عن المعرفة 
الركائز الخمس (المعرفة باختصار)
السياسات والإرشادات
المعرفة:المعرفة ليست
إخلاء مسؤولية
أي تطرح أسئلتك
الاتصال بالمعرفة مُباشرةً
من يكتب المعرفة؟
لماذا إنشاء حساب؟
المساهمة في المعرفة 
نظرة عامّة
طلب المساعدة
تجنب الأخطاء الشائعة
قواعد النقاش
القواعد المُبسّطة (تجاهل كل القواعد)
نصيحة اليوم
مقالتك الأولى (معالج إنشاء المقالات)
التخريب
المحرر المرئي
المقدمات 
التحرير
الاستكشاف
الصور
الوسائط
التصفّح
السياسات والإرشادات
الاستشهاد
الجداول
صفحات النقاش
الوصلات
الدروس 
التحرير
التنسيق
الصور
السياسات
التسجيل
الوصلات الداخلية
الوصلات الخارجية
صفحات النقاش
دليل استخدام المحرر المرئي
الأسئلة المُتكررة 
الأسئلة العامّة
الإدارة
مواضيع المقالات
التصنيفات
المساهمة
حقوق الصور
تحرير الصفحات
الدردشة الحيّة
القرّاء
المدارس
التقنيّة
مساعدة:محتويات 
قائمة المساعدة
التصفح
الانضمام
التحرير
الوصلات والمراجع
الصور والوسائط
متابعة التغييرات
السياسات والإرشادات
طرح الأسئلة
مجتمع المعرفة
المصادر والقوائم
إعدادات الحساب
معلومات تقنيّة
خريط الموقع
كيف تفعل الأشياء
وصفحات المعلومات 
الكتب
التصنيفات
التوثيق / المراجع
التوثيق بالقوالب للمبتدئين
المصادر الموثوق بها
حقوق التأليف والنشر
فرق
التحرير
شريط التحرير
التضارب
الملفات
هوامش الصفحات
مصطلحات
صندوق المعلومات
الوصلات (الوصلات الخارجية)
تسجيل الدخول
التصفح
التصفح من الجوال
النطاقات
دمج الصفحات
اسم الصفحة
تحويل الصفحة
إعادة تسمية الصفحة
كلمات المرور
التراجع
البحث
صفحات النقاش (الأرشفة)
عناوين الإنترنت
مساهمات المستخدم
نص الويكي 
نص ويكي (قائمة مبسطة)
شريط رسم بياني
العمليات الحسابية
قوالب الاستشهاد
الأعمدة
النص الفائق
القوائم
الكلمات السحرية (مقدمة)
الرموز الموسيقية
الملفات الصوتية
الأقسام
الجداول (مقدمة)
القوالب
توثيق القوالب
نسخ القوالب
قوالب الرسائل
التضمين
أدوات المعرفة
الأدلّة 
دليل التصفح
دليل المساعدة
الدليل السريع
الأقسام
الأسئلة المتكررة
المصطلحات
قائمة الإرشادات
قائمة السياسات
اختصارات المعرفة
تلميحات

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)