Template {{convert}} calculates measurements from one unit (you can enter) to another one, and then presents the results. For example:

{{convert|2|km|mi}} → 2 کلومیٹر (1.2 میل)
{{convert|7|mi|km}} → 7 میل (11 کلومیٹر)

The available units are listed below. Units are case-sensitive always (kW, not KW and not kw). Multiple formatting and calculation options are listed below.

Unit name or symbol (abbreviation): 1 pound or 1 lb?

By default, the first value shows unit name, the second the symbol (or abbreviation). Use |abbr=on/off to change this behaviour:

{{convert|1|lb|kg}} → 1 پونڈ (0.45 کلوگرام) (To compare; default: first value shows unit name)
{{convert|1|lb|kg|abbr=on}} → 1 پونڈ (0.45 کلوگرام)
{{convert|1|lb|kg|abbr=off}} → 1 پونڈ (0.45 کلوگرام)
  • |abbr=in toggles the default behaviour (|abbr=out):
{{convert|1|lb|kg|abbr=in}} → 1 پونڈ (0.45 کلوگرام)

Adjective: a 10-mile distance

Use |adj=on to produce the adjective form. The difference:

{{convert|10|mi|km}} to go → 10 میل (16 کلومیٹر) to go. (To compare, default)
A {{convert|10|mi|km|adj=on}} distance → A 10-میل (16 کلومیٹر) distance. (Adjective form)

Rounding: 100 ft is 30 m or 30.5 m or 30.48 m?

By definition, 100 ft equals 30.48 میٹر. In practical use, it is common to round the calculated metric number. With that, there are several possibilities.

Default rounding

By default, the conversion result will be rounded either to precision comparable to that of the input value (the number of digits after the decimal point—or the negative of the number of non-significant zeroes before the point—is increased by one if the conversion is a multiplication by a number between 0.02 and 0.2, remains the same if the factor is between 0.2 and 2, is decreased by 1 if it is between 2 and 20, and so on) or to two significant figures, whichever is more precise. An exception to this is rounding temperatures (see below).
Examples of rounding
Input Displays as Note
{{convert|123|ft|m|-1}} 123 فٹ (40 میٹر)
{{convert|123|ft|m|0}} 123 فٹ (37 میٹر)
{{convert|123|ft|m|1}} 123 فٹ (37.5 میٹر)
{{convert|550|ft|m|0}} 550 فٹ (168 میٹر) Approximate value is 167.64 m
{{convert|550|ft|m}} 550 فٹ (170 میٹر) Rounds to 170, when approximate value is 167.64 m
{{convert|500|ft|m|0}} 500 فٹ (152 میٹر) Approximate value is 152.4 m
{{convert|500|ft|m}} 500 فٹ (150 میٹر) Rounds to 150, when approximate value is 152.4 m

Convert supports four types of rounding:

Round to a given precision: use |precision=

Specify the desired precision with the fourth unnamed parameter (or third unnamed parameter if the "convert to" parameter is omitted; or fifth unnamed parameter if a range is specified; or fourth unnamed parameter again if a range is specified and the "convert to" parameter is omitted; needs to be replaced with a "precision" named parameter). The conversion is rounded off to the nearest power of 110 this number. For instance, if the result is 8621 and the round number is "-2", the result will be 8600. If the result is "234.0283043" and the round number is "0", the result will be 234.

Round to a given number of significant figures: |sigfig=

To specify the output number to be with n significant figures use |sigfig=<number>:

  • To compare: {{convert|1200|ft|m}} → 1,200 فٹ (370 میٹر)
  • {{convert|1200|ft|m|sigfig=4}} → 1,200 فٹ (365.8 میٹر)
  • {{convert|1200|ft|m|sigfig=3}} → 1,200 فٹ (366 میٹر)
  • {{convert|1200|ft|m|sigfig=2}} → 1,200 فٹ (370 میٹر)
  • {{convert|1200|ft|m|sigfig=1}} → 1,200 فٹ (400 میٹر)

Setting |sigfig= is meaningless

  • {{convert|1200|ft|m|sigfig=0}} → 1,200 فٹ (370 میٹر)*

Round to a multiple of 5: 15, 20, 25, ...

Using |round=5 rounds the outcome to a multiple of 5.

{{convert|10|m|ft}} → 10 میٹر (33 فٹ)
{{convert|10|m|ft|round=5}} → 10 میٹر (35 فٹ)

Similar: using |round=25 rounds the outcome to a multiple of 25.

{{convert|10|m|ft}} → 10 میٹر (33 فٹ)
{{convert|10|m|ft|round=25}} → 10 میٹر (25 فٹ)
To compare: {{convert|10|m|ft|sigfig=4}} → 10 میٹر (32.81 فٹ)

In a range, one can round each value individually to the default. Use |round=each:

{{convert|10 x 200 x 3000|m|ft}} → 10 در 200 در 3,000 میٹر (33 فٹ × 656 فٹ × 9,843 فٹ)
{{convert|10 x 200 x 3000|m|ft|round=each}} → 10 در 200 در 3,000 میٹر (33 فٹ × 660 فٹ × 9,800 فٹ)

Round to a multiple of a given fraction: 2 316 inch

Specify the desired denominator using |frac=<some positive integer>. (Denominator is the below-the-slash number, for example the 3 in 13).

{{convert|5.56|cm|in|frac=16}} → 5.56 سینٹیمیٹر (2 316 انچ)
{{convert|8|cm|in|frac=4}} → 8 سینٹیمیٹر (3 14 انچ)

The fraction is reduced when possible:

{{convert|8|cm|in|frac=100}} → 8 سینٹیمیٹر (3 320 انچ)
{{convert|8|cm|in}} → 8 سینٹیمیٹر (3.150 انچ) (To compare)

Rounding the temperatures °C, °F and K

In temperatures, the conversion will be rounded either to precision comparable to that of the input value or to that which would give three significant figures when expressed in kelvins, whichever is more precise.

{{convert|10|C|F K}} → 10 °C (50 °F؛ 283 ک)

Note

For a temperature difference, like to convert "A rise of 10 °C", use |C-change=10 &tc.
{{convert|10|C-change|F-change K-change}} → A rise of 10 °C (18 °F؛ 10 ک)

Into multiple units: 10 °C (50 °F؛ 283 ک)

Separate the multiple output units by a space:

{{convert|10|C|F K}} → 10 °C (50 °F؛ 283 ک)
{{convert|5|km|mi nmi}} → 5 کلومیٹر (3.1 میل؛ 2.7 بحری میل)

If the output unit names contain spaces, use a '+' separator.

See also

For multiple-unit options like 1 ft 5 in, see #In input and #In output.

Ranges of values

A range: 6 to 17 kg (13 to 37 lb)

Range indicators are entered as the second parameter (between the values). Range separators can be:

Range separators in {{convert}}
Separator Convert Result Notes
- {{convert|3|-|6|ft}} 3–6 فٹ (0.91–1.83 میٹر) Input can be hyphen (-) or en dash (–), output uses en dashes
- &ndash;(en dash) {{convert|3|–|6|ft}} 3–6 فٹ (0.91–1.83 میٹر)
and {{convert|3|and|6|ft}} 3 و 6 فٹ (0.91 و 1.83 میٹر)
and&& {{convert|3|&|6|ft}} 3 &[آلہ تبدیل: نامعلوم اکائی] Same as and
and(-) {{convert|3|and(-)|6|ft}} 3 و 6 فٹ (0.91–1.83 میٹر) |abbr=on alters the punctuation
and(-)|abbr=on {{convert|3|and(-)|6|ft|abbr=on}} 3 و 6 فٹ (0.91–1.83 میٹر)
or {{convert|3|or|6|ft}} 3 یا 6 فٹ (0.91 یا 1.83 میٹر)
to {{convert|3|to|6|ft}} 3 تا 6 فٹ (0.91 تا 1.83 میٹر)
to(-) {{convert|3|to(-)|6|ft}} 3 تا 6 فٹ (0.91–1.83 میٹر) |abbr=on alters the punctuation
to(-)|abbr=on {{convert|3|to(-)|6|ft|abbr=on}} 3 تا 6 فٹ (0.91–1.83 میٹر)
to about {{convert|3|to about|6|ft}} 3 تا تقریباً 6 فٹ (0.91 تا تقریباً 1.83 میٹر)
+/- {{convert|3|+/-|6|ft}} 3 ± 6 فٹ (0.91 ± 1.83 میٹر)
+/-± &plusmn; {{convert|3|±|6|ft}} 3 ± 6 فٹ (0.91 ± 1.83 میٹر)
+ {{convert|3|+|6|ft}} 3 + 6 فٹ (0.91 + 1.83 میٹر)
, {{convert|3|,|6|ft}} 3, 6 فٹ (0.91, 1.83 میٹر)
, and {{convert|3|, and|6|ft}} 3 اور 6 فٹ (0.91 اور 1.83 میٹر)
, or {{convert|3|, or|6|ft}} 3 یا 6 فٹ (0.91 یا 1.83 میٹر)
by {{convert|3|by|6|ft}} 3 در 6 فٹ (0.91 در 1.83 میٹر)
x {{convert|3|x|6|ft}} 3 در 6 فٹ (0.91 میٹر × 1.83 میٹر) Scientific notation.
|abbr=on alters the punctuation
× &times; {{convert|3|×|6|ft}} 3 در 6 فٹ (0.91 میٹر × 1.83 میٹر)
x|abbr=on {{convert|3|x|6|ft|abbr=on}} 3 فٹ × 6 فٹ (0.91 میٹر × 1.83 میٹر)
xx |xx| is deprecated. Use |x| instead
* |*| is deprecated. Use |x| instead
to- |to-| is deprecated. Use |to(-)| instead
& |&| is deprecated. Use |and| instead
abbr=mos |abbr=mos is deprecated. Use |x| or |by| instead

Multiple dimensions: 6 میٹر × 12 میٹر (20 فٹ × 39 فٹ)

Use "by"
{{convert|6|by|12|ft|m}} → 6 در 12 فٹ (1.8 در 3.7 میٹر)
Use "×" or ""x""
{{convert|6|x|12|m|ft}} → 6 در 12 میٹر (20 فٹ × 39 فٹ)

In science, the formal way is to set |x| and |abbr=on (keeping dimensions right, like in area = x km2):

{{convert|6|x|12|m|ft|abbr=on}} → 6 میٹر × 12 میٹر (20 فٹ × 39 فٹ)

About feet, inch in ranges and multiples

While it is possible to enter feet, inch in a simple conversion, this is not possible for ranges:

Words

Spelling of unit name: UK metre or US meter?

Default spelling of units is en-UK. To show en-US spelling, use |sp=us:

{{convert|1|m|ft}} → 1 میٹر (3.3 فٹ)—default
{{convert|1|m|ft|sp=us}} → 1 میٹر (3.3 فٹ)

Spell out numbers: ten miles

To write a number in words, use |spell=in:

{{convert|10|mi|m|spell=in}} → دس (ten) میل (16,000 میٹر)

To spell out both in and out values, use |spell=on:

{{convert|10|mi|m|spell=on}} → دس (ten) میل (سولہ (sixteen) هزار میٹر)

To make first letter a capital, use |spell=In, |spell=On

{{convert|10|mi|m|spell=In}} → دس (ten) میل (16,000 میٹر)
{{convert|10|mi|m|spell=On}} → دس (ten) میل (سولہ (sixteen) هزار میٹر)

Remember that the spelling of the units (ft, m) is independently set by |abbr=. To the extreme:

{{convert|10|mi|m|spell=on|abbr=off|sp=us}} → دس (ten) میل (سولہ (sixteen) هزار میٹر)

Extra words: 4 planted acres

Incomplete section
{{convert|4|acre||adj=pre|planted}} → 4 planted acre (1.6 ha)

Extra adjective words: A 10-فٹ-long corridor

{{convert|4|ft|m|adj=mid|-long}} → 10-فٹ-long (3.0 میٹر)

Plurals: 1 inch, 2 inches

The unit symbol is singular always. Depending on the preceding number only, a unit name can be shown plural.

Exception

Entering the unit spelled |foot| forces singular output "foot", whatever the number is.

  • {{convert|100|foot|abbr=off}} → 100 فٹ (30 میٹر)

Extreme changes for grammatical structure: The 18-, 24- and 32-pounder (8, 11 and 15 kg) cannons

This example is from the article Fort McHenry:

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

You can't get this sentence structure as a direct result of using {{convert}} and its options. However, you can get the correctly converted numbers and the grammatical structure you want to use by using {{convert}} plus three stages of editing, previewing and saving versions of the text you wish to change.

Stage 1: Enter the input numbers and units in {{convert}} as usual (this stage is just to get the calculated output):
  • had {{convert|18 |, |24 |, |32 |lb |kg |0 }} cannons
Get the converted data below by clicking Preview or Save:
→ had 18, 24, 32 پونڈ (8, 11, 15 کلوگرام) cannons
Stage 2: Change the resulting text from a {{convert|...}} template result to plain code by adding subst: to the template name (short for "substitution") :
  • had {{subst:convert|18 |, |24 |, |32 |lb |kg |0 }} cannons
Double-check this by clicking Preview. The preview will show the converted numbers are still correct:
→ had 18, 24, 32 pounds (8, 11, 15 kg) cannons
Then click Save.
Stage 3: Click Edit at the top of the article again, and then go to the text in the editing window. You'll see that the text is there in plain code. The template {{convert|...}} itself will have disappeared. You can change the text as needed. The substituted text and plain code in the editing window in this example would be:
had 18,&nbsp;24,&nbsp;32 pounds (8,&nbsp;11,&nbsp;15&nbsp;kg) cannons
You can edit this text as usual to add the grammatical features you wish. In this example, editing the above text to:
  • had 18-,_24-_and_32-pounder (8,&nbsp;11_and_15&nbsp;kg) cannons
And then saving your edit will show the following result in the article text:
→ "had 18-, 24- and 32-pounder (8, 11 and 15 kg) cannons"

Numbers

Using an SI prefix: gigameter (Gm), or micrometer (μm)

بین الاقوامی نظام اکائیاتی سابقہ جات
متن علامت Factor
یوٹا Y 1024
زیٹا Z 1021
ایگزا E 1018
پیٹا P 1015
ٹیرا T 1012
گیگا G 109
میگا M 106
کلو k 103
ہیکٹو h 102
ڈیکا da 101
(نامعلوم) (none)  1
deci d 10−1
centi c 10−2
milli m 10−3
micro μ 10−6
nano n 10−9
pico p 10−12
femto f 10−15
atto a 10−18
zepto z 10−21
yocto y 10−24

Units can have an SI prefix like G before the unit: Gm, and giga before the name: gigameter. These are plain multiplication factors.

To illustrate, these are trivial calculations (from meter to meter), showing the multiplication factor:

  • 12 Gمیٹر (1.2×1010 میٹر)
  • 12 µمیٹر (1.2×10−5 میٹر)

The prefix can be added before the SI unit (here: unit m for meter):

  • {{convert|12|Gm|mi|abbr=on}} → 12 Gمیٹر (7,500,000 میل)
  • Mm: 12 Mمیٹر (7,500 میل)
  • km: 12 کلومیٹر (39,000 فٹ)
  • mm: 12  ملی میٹر (0.47 انچ)
  • μm: 12 µمیٹر (0.012  ملی میٹر)
  • um: 12 µمیٹر (0.012  ملی میٹر) (letter "u" can be used for "μ" here)

The prefix can be used in the output unit:

  • {{convert|12000|mi|Mm|abbr=on}} → 12,000 میل (19 Mمیٹر)
  • {{convert|12|in|μm|abbr=on}} → 12 انچ (300,000 µمیٹر)

As an exception, the non-SI unit "inch" can have the "μ" prefix too)

  • {{convert|12|μm|μin|abbr=on}} → 12 µمیٹر (470 µin)

Engineering notation: 7 × 106 m

In the unit: e6m

Engineering number notations like 7E6 (for 7 × 106) can be entered as a "prefix" to the unit:

{{convert|7|e6m}} → 7 ملین میٹر (23,000,000 فٹ)

The same is possible for the output unit:

{{convert|23,000,000|ft|e6m}} → 23,000,000 فٹ (7.0×10^6 میٹر)

Any standard unit (not a combination, multiple, or built-in unit) can have such a prefix:

e3 (thousand), e6 (million), e9 (billion), e12 (trillion), e15 (quadrillion).

Scientific notation: 1.23×10−14

In scientific notation, a number is written like 1.23×10−14.

With {{convert}}, the input can be in e-notation such as 12.3e4. This value is displayed as a power of ten, and the output is displayed in scientific notation, except that an output value satisfying 0.01 <= v < 1000 is shown as a normal number. In addition, if the output value is 1000 and sigfig=4 is used, the value is displayed as a normal number.

  • {{convert|12.3e-15|atm|atm|abbr=on}} → 12.3×10−15 atm (1.23×10−14 atm)
  • {{convert|0.00000005|atm|atm|abbr=on}} → 0.00000005 atm (5.0×10−8 atm)

Input with fractions: 1 12 انچ (38.1  ملی میٹر)

The number to convert can be written in fractions. Both / (keyboard slash) and (fraction slash) are accepted:

{{convert|1/2|in|mm|1}}12 انچ (12.7  ملی میٹر)
{{convert|1⁄2|in|mm|1}}12 انچ (12.7  ملی میٹر)

With integers, use a + sign

{{convert|2+1⁄2|in|mm|1}}2 12 انچ (63.5  ملی میٹر)

When negative, use a hyphen - and repeat it:

{{convert|-2-1⁄2|in|mm|1}}−2 12 انچ (−63.5  ملی میٹر)
{{convert|2-1⁄2|in|mm|1}} → 2–12 انچ (50.8–12.7  ملی میٹر) Note: this is read as a range
{{convert|-2+1⁄2|in|mm|1}}[آلہ تبدیل: invalid number] Red XN Should be a number, not an expression (do not require a calculation)

Output with horizontal fraction bar in: 1/2 inch

Using a double slash (//) returns a horizontal bar fraction:

  • {{convert|1//2|in|mm|1}}1/2 انچ (12.7  ملی میٹر)
  • {{convert|2+1//2|in|mm|1}}2 1/2 انچ (63.5  ملی میٹر)

Thousands separator: 1,000 mi and 1000 mi

In input, a comma for thousands separator is accepted but not required; a gap (space) is not accepted. In output, by default, the thousand separator is the comma:

  • {{convert|1234567|m|ft}} → 1,234,567 میٹر (4,050,417 فٹ)
  • {{convert|1,234,567|m|ft}} → 1,234,567 میٹر (4,050,417 فٹ)
  • {{convert|1 234 567|m|ft}}[آلہ تبدیل: invalid number] Red XN

Set |comma=off to remove the separator from the output:

  • {{convert|1234567|m|ft|comma=off}} → 1234567 میٹر (4050417 فٹ)*

Use |comma=gaps to use digit grouping by gap (thin space) as a thousands separator:

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

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

  • {{convert|1234|m|ft}} → 1,234 میٹر (4,049 فٹ) (To compare, default)
  • {{convert|1234|m|ft|comma=5}} → 1234 میٹر (4049 فٹ)
  • {{convert|1234567|m|ft|comma=5}} → 1,234,567 میٹر (4,050,417 فٹ)
  • {{convert|1234|m|ft|comma=gaps5}}1234 میٹر (4049 فٹ)*
  • {{convert|1234567|m|ft|comma=gaps5}}1234567 میٹر (4050417 فٹ)*

Output manipulation

Brackets and separators: 10 m [33 ft]

Punctuation that distinguishes the two measurements is set by |disp=.
Options are: b (the default), sqbr, comma, or, br, x|...:

{{convert|10|m|ft}} → 10 میٹر (33 فٹ)—( ) brackets are the default
{{convert|10|m|ft|disp=sqbr}} → 10 میٹر [33 فٹ]
{{convert|10|m|ft|disp=comma}} → 10 میٹر، 33 فٹ
{{convert|10|m|ft|disp=or}} → 10 میٹر یا 33 فٹ

Setting |disp=br will force a new line (<br>)

{{convert|10|m|ft|disp=br}} → 10 میٹر
33 فٹ

Also |disp=br() will force a new line, and keep the brackets:

{{convert|10|m|ft|disp=br()}} → 10 میٹر
(33 فٹ)

Setting |disp=x|... allows any text as separator:

{{convert|10|m|ft|disp=x|_MyText_}} → 10 میٹر_MyText_33 فٹ—(To display spaces, use &nbsp;)

Flipping (reordering) the two measurements: 1,609.3 میٹر (1 میل)

Setting |order=flip will flip (swap) the two measurements:

{{convert|1|mi|m}} → 1 میل (1,609.3 میٹر) (To compare, default)
{{convert|1|mi|m|order=flip}} → 1,609.3 میٹر (1 میل)

When converting to multiple units, the effect is:

{{convert|10|km|mi nmi|order=flip}} → 6.2137 میل؛ 5.3996 بحری میل (10 کلومیٹر)
{{convert|10|km|nmi mi|order=flip}} → 5.3996 بحری میل؛ 6.2137 میل (10 کلومیٹر)

Displaying parts of the result: 2 (1.5)

It is possible to display only parts of the conversion result:

Convert Output Description
{{convert|2|cuyd|m3}} 2 یارڈ مکعب (1.5 میٹر3) Default, to compare
{{convert|2|cuyd|m3|abbr=values}} 2 (1.5) Input and output numbers
{{convert|2|cuyd|m3|disp=unit}} یارڈ مکعب Input unit
{{convert|2|cuyd|m3|disp=unit|adj=on}} یارڈ-مکعب Input unit, adjective (hyphenated)
{{convert|2|cuyd|cuyd|0|disp=out|abbr=off}} 2 یارڈ مکعب Input (workaround)
{{convert|2|cuyd|m3|abbr=~}} 2 یارڈ مکعب [cu yd] (1.5 میٹر3) Input: both name and symbol
{{convert|2|cuyd|m3|disp=unit2}} میٹر3 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 میٹر3 Output value and unit
{{convert|2|cuyd|m3|disp=out|abbr=off}} 1.5 مکعب میٹر Output value and unit

Display input name and symbol: 2 kilopascals [kPa]

Setting |abbr=~ returns both name and symbol of the first (input) unit:

{{convert|2|kPa|psi|abbr=~}} → 2 کلوپاسکال [کلوPa] (0.29 psi)
A {{convert|2|kPa|psi|abbr=~|adj=on}} pressureA 2-کلوپاسکال [کلوPa] (0.29 psi) pressure

Table options

For the wikitable structure, there are three options: add a line-break, split the result over columns and make the table sortable.

Enforced line break

|disp=br adds a line-break and omits brackets.

|disp=br() adds a line-break and does add brackets to the converted value. This may be useful in tables:

|disp=br |disp=br()
100 کلومیٹر
62 میل
100 کلومیٹر
(62 میل)

Table columns showing numbers only

Using {convert} in a table cell, with |disp=table splits the result over two columns:

{{convert|10|m|ft|disp=table}} → style="text-align:right;"|10

|style="text-align:right;"|33

|disp=tablecen does the same, and also centers the text:

{{convert|20|m|ft|disp=tablecen}} → style="text-align:center;"|20

|style="text-align:center;"|66

The units are added as a column header:

  m ft
|disp=table 10 33
|disp=tablecen 20 66
|disp=<other> (default) 30 میٹر (98 فٹ)

Sorting

Use |sortable=on to include a hidden numerical sortkey in the output, suitable for use in a table with sortable columns. Technically, this places a hidden string before the actual displayed values:

{{convert|10|m|ft|sortable=on}}<span style="display:none">7001100000000000000</span>10 metres (33&nbsp;ft)

Use both |disp=table and |sortable=on together to produce table columns (pipe symbols) for each value in sortable columns:

m ft
A 15 34 52
B 15.5 51
C 16.0 52.5
D 16 52

The generated sortkey is calculated in a consistent way based on both the value and its unit as passed to the convert template. In most cases convert uses the passed value converted to SI base units. It is therefore not necessarily the displayed value or other alternate units and is calculated regardless of output format options. Using different units or different order of units in individual rows should therefore not lead to incorrect sorting, although variations in rounding can give surprising results, since an unrounded number is used for the sortkey.

Units

The table below lists units supported by template {{convert}}. The list is not complete—more complete lists are linked for each dimension. A complete list is at the full list of units.

Explanation – unit codes

The {{convert}} template uses unit-codes, which are similar to (but not necessarily exactly the same as) the usual written abbreviation for a given unit. These 'unit-codes' are given in column 3 of the following tables, and are accepted as input by the {{convert}} template as the second and third unnamed parameters. For example, {{convert|100|kg|lb}} produces "100 کلوگرام (220 پونڈ)" and {{convert|100|lb|kg}} produces "100 پونڈ (45 کلوگرام)"

Some units have alternative unit-codes; these are shown in brackets in column 3, e.g. °F (F): either may be entered for Fahrenheit (but not lower-case f).

The unit-codes should be treated as case-sensitive, especially in cases like {{convert|100|Mm|mm}}, which produces "100 میگامیٹر (1.0×1011  ملی میٹر)".

The output of {{convert}} can display multiple converted units, if further unit-codes are specified after the second unnamed parameter (without the | separator). Typical combination output units are listed below in column 7. For example, {{convert|55|nmi|km mi}} produces "55 بحری میل (102 کلومیٹر؛ 63 میل)", and {{convert|1|oz|ozt g gr}} produces "1 اونس (0.91 ozt؛ 28 گرام؛ 440 gr)".

سانچہ:Convert/list of units/volume/short list
Abridged list of units supported by {{Convert}}
Explanation
system unit code
(alternative)
symbol/abbreviation notes conversion factor combinations
the system(s) to which the unit belongs units listed by name codes that can be entered when using the template symbols/abbreviations as displayed by the template notes which may pertain to the units in general or specifically to their use in this template conversion factors used by the template to convert to and from the SI base unit codes for multiple conversions


Area
(Full list)
system unit code
(alternative)
abbreviation notes conversion factor/m2 combinations
SI مربع کلومیٹre km2 کلومیٹر2 US spelling: square kilometer
1,000,000
  • km2 sqmi
مربع میٹرre m2 میٹر2 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
مربع میل sqmi مربع میل 2,589,988.110336
  • sqmi km2
ایکڑ acre 4,046.856422
مربع گز sqyd مربع گز 0.83612736
square فٹ sqft
(sqfoot)
مربع فٹ The sqfoot code will produce square foot as the plural form. 0.09290304
  • sqft m2 (sqfoot m2)
مربع انچ sqin مربع انچ 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)

سانچہ:Convert/list of units/density/short list

Energy
(Full list)
system unit code
(alternative)
abbreviation 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 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
الیکٹرون وولٹ 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 حرارہ Cal حرارہ The thermochemical calorie is the default definition. For other definitions 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 (energy) 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.537696173000
British thermal unit British thermal unit Btu Btu The International Steam Table British thermal unit is the default definition. For other definitions see the full list. 1,055.05585262
BTU BTU
TNT-based units gigatonne of TNT GtTNT 4.184×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)
The cufootnaturalgas code will produce cubic foot of natural gas as the plural form. 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


Force
(Full list)
system unit code
(alternative)
abbreviation notes conversion factor/N combinations
SI giganewton GN GN Triple combinations are also possible. See the full list. 1,000,000,000
  • GN LT-f
  • GN LTf
  • GN ST-f
  • GN STf
meganewton MN MN Triple combinations are also possible. See the full list. 1,000,000
  • MN LT-f
  • MN LTf
  • MN ST-f
  • MN STf
kilonewton kN kN Triple combinations are also possible. See the 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
ounce-force oz-f ozf 0.2780138203095378000
ozf ozf
grain-force gr-f grf 0.0006354602307515
grf grf


Length
(Full list)
system unit code
(alternative)
abbreviation notes conversion factor/m combinations
SI megametre Mm Mm US spelling: megameter
1,000,000
کلومیٹر km کلومیٹر US spelling: kilometer
1,000
  • km mi
میٹر 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
میل 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
فٹ ft (foot) فٹ The foot code will produce foot as the plural form. 0.3048
  • ft m (foot m)
hand hand h 0.1016
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.08567758130570×10^16
light-year ly ly 9.4607304725808×10^15
فلکیاتی اکائی AU AU 149,597,870,691


Mass
(Full list)
system unit code
(alternative)
abbreviation notes conversion factor/kg combinations
SI کلوگرام kg کلوگرام Triple combinations are also possible. See the 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 Triple combinations are also possible. See the 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
Triple combinations are also possible. See the full list.
1,016.0469088
  • LT t
  • LT MT
  • LT ST
long ton
short ton ST 2,000 lb
used mostly in the US
Triple combinations are also possible. See the 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
Triple combinations are also possible. See the full list.
6.35029318
  • st kg
  • st lb
پاؤنڈ lb پاؤنڈ Triple combinations are also possible. See the 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


Speed
(Full list)
system unit code
(alternative)
abbreviation 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 The foot/s code will produce foot per second as the plural form. 0.3048
  • ft/s m/s
Maritime units knot kn (knot) kn (4.63/9)
  • kn mph


Temperature
(Full list)
system unit code
(alternative)
abbreviation notes conversion
to kelvin
combinations
SI kelvin K K Triple combinations are also possible. See the 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 فارنہائٹ °F (F) °ف (([°F]+459.67)/1.8)
  • °F K (F K)
  • °F °C (F C)
  • °F °R (F R)


TORQUE
(Full list)
system unit unit-
code
abbrev-
iation
notes sample default
conversion
combination
output units
Industrial
SI نیوٹن میٹر Nm N·m Triple combinations are also possible. See the full list. 1.0 N·m (0.74 پونڈ·فٹ)
  • Nm kg.m
  • Nm lb.ft
Non-SI metric کلوگرام میٹر kg.m کلوگرام·میٹر 1.0 کلوگرام·میٹر (9.8 N·m؛ 7.2 پونڈ·فٹ)
  • kg.m Nm
  • kg.m lb.ft
Imperial
&
US customary
پونڈ قوت-فٹ lb.ft پونڈ·فٹ 1.0 پونڈ·فٹ (1.4 N·m)
  • lb.ft Nm
  • lb.ft kg-m
Scientific
SI نیوٹن میٹر N.m N·m Triple combinations are also possible. See the full list. 1.0 N·m (0.74 پونڈ·فٹ)
  • N.m kgf.m
  • N.m lbf.ft
Non-SI metric کلوگرام قوت-میٹر kgf.m kgf·m 1.0 kgf·m (9.8 N·m؛ 7.2 پونڈ·فٹ)
  • kgf.m N.m
  • kgf.m lbf.ft
Imperial
&
US customary
پونڈ قوت-فٹ lbf.ft پونڈ·فٹ 1.0 پونڈ·فٹ (1.4 N·m)
  • lbf.ft N.m
  • lbf.ft kgf.m
Pressure
unit code abbreviation 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 code
(alternative)
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 (lower case hp for horsepower, for example)
Population density
unit code
(alternative)
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

Multiple units: 1 ft 5 in

In input

Base document #Input multiples lists options for multiple unit input (like ft,in). It can catch predefined sets only (units that can be subdivided, e.g. yd into ft):

  • {{convert|1|yd|2|ft|3|in}} → 1 یارڈ 2 فٹ 3 انچ (1.60 میٹر)
  • {{convert|2|ft|3|in|cm}} → 2 فٹ 3 انچ (69 سینٹی میٹر)
  • {{convert|1|lb|5|oz|g}} → 1 پونڈ 5 اونس (600 گرام)

In output

Available multiple-unit output options predefined, like ftin and ydftin. The full list is at #Output multiples.

  • {{convert|2|m|ftin}} → 2 میٹر (6 فٹ 7 انچ)
  • {{convert|2|m|ft in}} → 2 میٹر (6.6 فٹ؛ 79 انچ)—using a space, returns the decimal point
  • {{convert|2|m}} → 2 میٹر (6 فٹ 7 انچ)—the default
See also
  • {{hands}} a length used to measure horses.

'per' units: kg/hl

When using a slash (/), a unit like kg/hl is recognized as kilograms per hectolitre and will be converted with other mass/volume units.

  • {{convert|1000|kg/hl}}لوا خطا ماڈیول:Convert میں 644 سطر پر: attempt to index field 'per_unit_fixups' (a nil value)۔

Currency per unit: $/mi, $/km

Using currency symbols in a $ per unit value, you can convert the per-unit:

  • {{convert|10|$/mi|$/km}} → $10 فی میل ($6.2/کلومیٹر) سبز نشانY
You can set the unit in both values using |$=€:
  • {{convert|10|$/mi|$/km|$=€}} → €10 فی میل (€6.2/کلومیٹر)

You can not convert the currency. This outcome combination is not possible: $15 per mile (€8.6/km)

Parameter list

سانچہ:Convert/doc/parameter list

Deprecated options

سانچہ:Convert/doc/deprecations list

TemplateData

ذیل میں اس سانچہ کی معلومات سانچہ دستاویز درج ہے جنہیں بصری خانہ ترمیم اور دیگر آلات استعمال کرتے ہیں۔

معلومات سانچہ تحویل

Converts measurements to other units.

محددات سانچہ[انتظام TemplateData]

پیرامیٹروضاحتطرزحالت
value1

the value to convert

عدداختیاری
from unit2

سطراختیاری
to units3

the unit to convert into

سطراختیاری
precision or suffix4

significant digits after decimal dot or, if negative, exponent of ten

عدداختیاری
link unitslk

“on” all, “in” input, “out” output or “off” no units

طے شدہ
off
سطراختیاری
abbreviationabbr

display for the units: “on” unit symbols, “off” all unit names in full words, “in” input unit symbol, “out” abbreviated output units, “values” no units at all

طے شدہ
out
سطراختیاری
spellingsp

“us” display U.S. spelling of unit names

سطراختیاری
adjectiveadj

adjective form (singular unit name appended by hyphen) “on” or “mid” to put conversion at end

سطراختیاری
conversiondisp

display conversion result: “or” after ‘or’, “x” with custom prefix and suffix, “b” in parentheses, “table”/“tablecen”, “output only” alone, “output number only” alone and without unit, “unit” not at all but input unit; if the value is a number it is used as precision

طے شدہ
b
سطراختیاری
orderingorder

“flip” returns converted value first, input value second.

سطراختیاری
significant figuressigfig

number that sets the number of significant figures

عدداختیاری
rounding outputround

“5” rounds the output number to nearest multiple of 5, “25” to nearest multiple of 25, “each” rounds each number in a range

سطراختیاری
thousands separatorcomma

Sets or suppresses thousand separator in the numbers. “off” = no separator; “gaps”: use space not comma; “5” and “gaps5”: only add separator when number > 5 positions (10,000 or more)

طے شدہ
on
سطراختیاری
sort keysortable

“on” generates a hidden sort key

سطراختیاری

See also

سانچہ:Convert navs