Iz Wikipedije, proste enciklopedije
Jump to navigation Jump to search
Documentation icon Dokumentacija predloge[predogled] [uredi] [zgodovina] [osveži]



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

Styles include: distance "32 m (105 ft)" and "32 m ali 105 ft"; temperature "18 °C (64 °F)"; mass "550 kg (1.210 lb)" or "65 do 80 kg (143 do 176 lb)"; etc. For units see: Convert/list of units.

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

Single value:


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

{{convert|val1|range|val2 |in_unit|out_unit|round_to|...}}
{{convert/3 |val1|range|val2|words|val3|in_unit|out_unit|round_to|...}}
  • Optional parameters, in examples below, allow abbreviated units (abbr=on), or U.S. spellings (sp=us for meter), or hyphenation (adj=on), etc.
  • This template may in some cases directly convert to other base units, for example {{convert|29,8|km/s|mi/h}} will directly convert the km/s to mph, as in 29,8 km/s (67.000 mph).
  • For this template many levels of substitution are possible, hence doing this fully, step by step, is cumbersome. Use Special:ExpandTemplates instead.
  • The template provides some dimensional analysis to check for compatible units. The user should be careful that input and output units are compatible. Do not, for example, attempt to convert barrels to tonnes (but see {{bbl to t}}). Also beware of units with similar names; the code oz, for example, is for the avoirdupois ounce (a unit of mass), do not use this if you want fluid ounces. Note also that the code lb gives pounds mass, for pounds force use lbf.
  • This documentation page tends to lag behind in terms of what the template can do. For more details, see the talk page and its archives.


Single value

Input Displays as
{{convert|3,21|kg|lb}} 3,21 kg (7,1 lb)
{{convert|3,21|kg|lb|0}} 3,21 kg (7 lb)
{{convert|10|kg|lb|disp=or}} 10 kg ali 22 lb
{{convert|6|ft|5|in|m}} 6 ft 5 in (1,96 m)
{{convert|10|mi}} 10 mi (16 km)
{{convert|100|mpgus}} 100 mpg-US (2,4 L/100 km; 120 mpg-imp)
{{convert|120|km/h}} 120 km/h (75 mph)
{{convert|18|°C|°F}} 18 °C (64 °F)
{{convert|-15|C|F}} −15 °C (5 °F)
{{convert|9|e6USgal|abbr=off}} 9 milijon ameriških galon (34 megalitrov)
The "e6" scales the input to millions; the "abbr=off" yields the "mega" in the output.
Scaling is only available for Single value conversions. Not all units are supported.
{{convert|1250|sqft|m2|lk=in|sigfig=2}} 1.250 sq ft (120 m2)
Note 'lk=in' links only the input unit. This example is for illustration only, common units of measurement should not be linked. See: wp:overlink.
{{convert|20,5|m3|cuyd|lk=out|abbr=on}} 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 akrov (259 ha; 1,002 sq mi)
Note 'lk=on' links all units. Per guidelines, common units should not be linked. See: wp:overlink.
{{convert|641|acre|ha sqmi|2|lk=on}} 641 akrov (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 and it may be necessary to enter as "convert/2" rather than simply "convert"
Input Displays as
{{convert|60|and|170|kg|lb}} 60 & 170 kg (130 & 370 lb)
{{convert|60|to|170|kg|lb}} 60 do 170 kg (130 do 370 lb)
{{convert|60|to(-)|170|kg|lb}} 60–170 kg (130–370 lb)
{{convert|60|-|170|kg|lb}} 60–170 kg (130–370 lb)
{{convert|41|to|50|F|C}} 41 do 50 °F (5 do 10 °C)
{{convert|-10|to|-20|C|F}} −10 do −20 °C (14 do −4 °F)
{{convert|41|-|50|F|K}} 41–50 °F (278–283 K)
{{convert|60|by|120|ft}} 60 krat 120 m (200 krat 390 ft)
{{convert|60|x|120|m|ft|abbr=on}} 60 × 120 m (200 × 390 ft)
{{convert|60|+/-|10|m|ft}} 60 ± 10 m (197 ± 33 ft)
{{convert|19|to|27|L|USgal}} 19 do 27 L (5,0 do 7,1 US gal)
{{convert|5|to|7|L|USgal}} 5 do 7 L (1,3 do 1,8 US gal)
{{convert|4|-|9|L|USgal|abbr=off}} 4–9 litrov (1,1–2,4 ameriške galone)

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

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

Range/set of 3 or 4 values

Note: not yet operational for all units
Input Displays as
{{convert |60|by|100|by|120|m|ft}} 60 krat 100 krat 120 m (200 krat 330 krat 390 ft)
{{convert/3 |60|x|100|x|120|m|ft|abbr=mos}} 60×100×120 m (200×330×390 ft)
{{convert/3 |60|-|70|-|80|kg|lb}} 60–70–80 kg (130–150–180 lb)
{{convert/4 |60|-|70|-|80|-|90|kg|lb}} Predloga:Convert/4
{{convert/3 |60|to|80|or|85|m|ft}} 60 to 80 or 85 m (200 to 260 or 279 ft)
{{convert/3 |11|by|15|rarely|16|ft|m}} 11 by 15 rarely 16 ft (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/4 |2|to|12|, in summer|25|to|36|C|F}} Predloga:Convert/4
{{convert/3 |41|-|50|almost|51|F|K}} 41–50 almost 51 °F (278–283 almost 284 K)

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


Use US spelling attach |sp=us   to show "meter" rather than "metre" (etc.)
Make units linked attach |lk=on   to link all units (default: lk=off)
attach |lk=in   to link only the input units
attach |lk=out  to link only the output units
(The manual of style suggests that you should not link common units of measurement).
Use the adjective form, or insert mid-text words attach |adj=on (e.g. "190-foot (58 m) bridge" instead of "190 feet...").
This produces the adjective form, as the unit name in the singular with a hyphen (according to the Manual of Style).

attach |adj=mid (e.g. "190-foot bridge (58 m)" as: |adj=mid|bridge

or "190-foot-long bridge (58 m)" as: |adj=mid|-long bridge

Note 1: Any rounding-parameter should follow the mid-text: "text|0".
Note 2: For adj=mid, must specify both input & output unit-codes.

For example, to convert feet, use "ft|m" or "ft|0":
  • {{convert|9|ft|m|adj=mid|-long}} → 9-foot-long (2,7 m)
To default the output unit-code, set parameter 3 to: 0.
Abbreviate units, or not attach |abbr=on    to show unit symbols
attach |abbr=off   to show all unit names in full words
attach |abbr=in    to abbreviate input units
attach |abbr=out   to abbreviate output units
attach |abbr=~      to show input unit symbol in result
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=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.
Example: {{convert|7500|acre|m2|disp=output only }} → 30.000.000 m2
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. Example: here
Round to a specified number of significant figures attach |sigfig={some integer greater than zero}. In the case of temperatures Celsius or Fahrenheit this refers to the difference with the absolute-zero temperature. For example, at room temperature two significant digits means rounded to tens of degrees.
Round by 5 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|ft}} gives 100 km (330.000 ft) and {{convert|100|km}} gives 100 km (62 mi).
Display input value with a fraction {{convert|3/8|in|mm|3|abbr=on}} → 38 in (9,525 mm) or {{convert|11+1/4|in|cm|2|abbr=on}} → 11 14 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, ie, if you use 6|ft|2|in as the value, it will only use the 6 for the sort key. This will cause numeric values to sort in numeric order, ie: 5, 10, 15 instead of 10, 15, 5.

Parameters still under construction

Parameters still under construction. May not work in all situations
disp=5[note 1] The output will be rounded to the nearest 5 units. Might not work when linking unit names.
disp=tablecen[note 1] Similar to disp=table except that the values with be centered within the column. See the tables at La Nouvelle branch, BM-21 Grad for in use examples.
abbr=in Abbreviates only the input unit.
abbr=out Abbreviates only the output unit.
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 "[ ]".
  1. 1,0 1,1 This is a limited, temporary option, until an alternative can be implemented.


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 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.
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 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 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 more precise.
Examples of default rounding
Input Displays as Note
{{convert|550|ft|m|0}} 550 ft (168 m) Approximate value is 167,64 m
{{convert|550|ft|m}} 550 ft (170 m) Rounds to 170, when approximate value is 167,64 m
{{convert|500|ft|m|0}} 500 ft (152 m) Approximate value is 152,4 m
{{convert|500|ft|m}} 500 ft (150 m) Rounds to 150, when approximate value is 152,4 m

Units supported

See also: Convert/list of units

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

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

The codes listed in the combinations column (column 7) can be used to produce multiple conversions. They can only be used as the third unnamed parameter, e.g. {{convert|55|nmi|km mi}} produces "55 nmi (102 km; 63 mi)".

Abridged list of units supported by {{Convert}}
sistem enota enota-
simbol ali
opombe vzorec
izhodnih enot
sistem(i), ki jim enota pripada enote navedene z imenom enota-koda za uporabo v predlogi izhodni simboli druge opombe o enotah vzorec pretvorbe izhodne kode za kombinacije pretvorb

(Polni seznam)
sistem enota enota-
simbol ali
opombe vzorec
izhodnih enot
SI Mm Mm Mm US spelling: megameter
10 Mm (6.200 mi)
km km km US spelling: kilometer
10 km (6,2 mi)
  • km mi
m m m US spelling: meter
10 m (33 ft)
  • m ft
  • m ftin
cm cm cm US spelling: centimeter
10 cm (3,9 in)
  • cm in
mm mm mm US spelling: millimeter
10 mm (0,39 in)
  • mm in
µm μm (um) µm US spelling: micrometer
10 µm (0,00039 in)
nm nm nm US spelling: nanometer
10 nm (3,9×10−7 in)
non-SI metric Å Å
Å 10 Å (3,9×10−8 in)
US customary
mi mi mi 10 mi (16 km)
  • mi km
furlong furlong (none) 10 furlong (6.600 ft; 2.000 m)
chain chain (none) 10 chain (660 ft; 200 m)
rd rd rd For other names of this unit see the full list. 10 rd (160 ft; 50 m)
fathom fathom (none) assumes 1 fathom ≡ 6 ft 10 fathom (60 ft; 18 m)
yd yd yd assumes the international definition 10 yd (9,1 m)
ft ft (foot) ft code "foot" will show "foot" if plural.

code "ft" will show "foot" or "feet" depending on value.

10 ft (3,0 m)
  • ftin (feet and inches)
  • ft m (foot m)
in in in 10 in (250 mm)
  • in cm
  • in mm
Other nmi nmi nmi the international standard nautical mile
For other nautical miles see the full list.
10 nmi (19 km; 12 mi)
pc pc pc 10 pc (33 ly)
ly ly ly 10 ly (630.000 AU)
AU AU AU 10 AU (1,5×109 km; 930.000.000 mi)

(Polni seznam)
sistem enota enota-
simbol ali
opombe vzorec
izhodnih enot
SI km2 km2 km2 US spelling: square kilometer
10 km2 (3,9 sq mi)
  • km2 sqmi
m2 m2 m2 US spelling: square meter
10 m2 (110 sq ft)
  • m2 sqft
cm2 cm2 cm2 US spelling: square centimeter
10 cm2 (1,6 sq in)
  • cm2 sqin
mm2 mm2 mm2 US spelling: square millimeter
10 mm2 (0,016 sq in)
  • mm2 sqin
non-SI metric ha ha ha 10 ha (25 akrov)
US customary
sq mi sqmi sq mi 10 sq mi (26 km2)
  • sqmi km2
aker acre (none) 10 akrov (4,0 ha)
sq yd sqyd sq yd 10 sq yd (8,4 m2)
sq ft sqft
sq ft code "sqfoot" will show "square foot" if plural.

code "sqfoot" will show "foot" or "feet" depending on value.

10 sq ft (0,93 m2)
  • sqft m2 (sqfoot m2)
sq in sqin sq in 10 sq in (65 cm2)
  • sqin cm2
Other sq nmi sqnmi sq nmi 10 sq nmi (34 km2; 13 sq mi)
dunam dunam (none) For alternative spellings and definitions see the full list 10 dunam (0,010 km2; 0,0039 sq mi)
tsubo tsubo (none) 10 tsubo (33 m2)

(Polni seznam)
sistem enota enota-
simbol ali
opombe vzorec
izhodnih enot
SI m3 m3 m3 US spelling: cubic meter
one kilolitre
10 m3 (350 cu ft)
cm3 cm3 cm3 US spelling: cubic centimeter
one millilitre
10 cm3 (0,61 cu in)
cc cc
mm3 mm3 mm3 US spelling: cubic millimeter
10 mm3 (0,00061 cu in)
non-SI metric kl kl kl US spelling: kiloliter
one cubic metre
10 kl (350 cu ft)
kL kL
l l l US spelling: liter
one cubic decimetre
Allows triple output units. See: polni seznam.
10 l (2,2 imp gal; 2,6 US gal)
  • l impgal
  • l USgal
  • l
  • l USdrygal
  • l U.S.drygal
  • L impgal
  • L impqt
  • L USgal
  • L
  • L USdrygal
  • L U.S.drygal
cl cl cl US spelling: centiliter
10 cl (3,5 imp fl oz; 3,4 US fl oz)
cL cL
ml ml ml US spelling: milliliter
one cubic centimetre
10 ml (0,35 imp fl oz; 0,34 US fl oz)
  • ml impoz
  • ml USoz
  • ml U.S.oz
mL mL
  • mL impoz
  • mL USoz
  • mL U.S.oz
US customary
cu yd cuyd cu yd 10 cu yd (7,6 m3)
cu ft cuft (cufoot) cu ft code "cufoot" will show "cubic foot" if plural.

code "cufoot" will show "foot" or "feet" depending on value.

10 cu ft (0,28 m3)
cu in cuin cu in 10 cu in (160 cm3)
Imperial imp bbl impbbl imp bbl 36 imp gal 10 imp bbl (1.600 l; 360 imp gal; 430 US gal)
imp bsh impbsh imp bsh 8 imp gal 10 imp bsh (360 l; 80 imp gal; 83 US dry gal)
impbu imp bu
imp gal impgal imp gal 4.54609 litres by definition, also
4 imp qt or 8 imp pt or 160 imp fl oz
Allows triple output units. See: polni seznam.
10 imp gal (45 l; 12 US gal)
  • impgal l
  • impgal L
  • impgal USgal
  • impgal
  • impgal USdrygal
  • impgal U.S.drygal
imp qt impqt imp qt 1/4 imp gal or 40 imp fl oz 10 imp qt (11.000 ml; 380 US fl oz)
imp pt imppt imp pt 1/8 imp gal or 20 imp fl oz 10 imp pt (5,7 l)
imp fl oz impoz (impfloz) imp fl oz 1/160 imp gal 10 imp fl oz (280 ml; 9,6 US fl oz)
  • impoz USoz
  • impoz U.S.oz
  • impoz ml
  • impoz mL
US customary
liquid measure
US bbl USbbl US bbl 31½ US gal
used for liquids except for oil and beer (see the full list)
10 US bbl (1.200 l; 310 US gal; 260 imp gal)
U.S.bbl U.S. bbl
bbl oilbbl bbl 42 US gal 10 bbl (1,6 m3)
US bbl USbeerbbl
US bbl 10 US bbl (1.200 l; 310 US gal; 260 imp gal)
U.S. bbl
US gal 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: polni seznam.
10 US gal (38 l; 8,3 imp gal)
  • USgal l
  • USgal L
  • USgal impgal U.S. gal
  • USgal l
  • USgal L
  • USgal impgal
US qt USqt US qt 1/4 US gal or 32 US fl oz 10 US qt (9.500 ml)
U.S.qt U.S. qt
US pt USpt US pt 1/8 US gal or 16 US fl oz 10 US pt (4,7 l; 8,3 imp pt) U.S. pt
US fl oz USoz
US fl oz 1/128 US gal 10 US fl oz (300 ml)
  • USoz ml
  • USoz mL
  • USoz impoz
U.S. fl oz
  • U.S.oz ml
  • U.S.oz mL
  • U.S.oz impoz
US customary
dry measure
US dry bbl USdrybbl US dry bbl 105/32 US bsh 10 US dry bbl (1,2 m3)
U.S.drybbl U.S. dry bbl
US bsh USbsh US bsh 2150.42 cubic inches by definition 10 US bsh (350 l; 80 US dry gal; 78 imp gal)
U.S.bsh U.S. bsh
US bu USbu US bu 2150.42 cubic inches by definition 10 US bu (350 l; 80 US dry gal; 78 imp gal)
U.S.bu U.S. bu
US dry gal USdrygal US dry gal 1/8 US bsh
Allows triple output units. See: polni seznam.
10 US dry gal (44 l)
  • USdrygal l
  • USdrygal L
  • USdrygal impgal
U.S.drygal U.S. dry gal
  • U.S.drygal l
  • U.S.drygal L
  • U.S.drygal impgal
US dry qt USdryqt US dry qt 1/32 US bsh 10 US dry qt (11.000 ml)
U.S.dryqt U.S. dry qt
US dry pt USdrypt US dry pt 1/32 US bsh 10 US dry pt (5.500 ml)
U.S.drypt U.S. dry pt

Predloga:Convert/list of units/speed/short list Predloga:Convert/list of units/force/short list Predloga:Convert/list of units/energy/short list Predloga:Convert/list of units/temperature/short list Predloga:Convert/list of units/mass/short list Predloga:Convert/list of units/torque/short list Predloga:Convert/list of units/extra



To je TemplateData dokumentacija za predlogo, ki jo uporablja VisualEditor in druga orodja;glejte mesečno napakovno poročilo za to predlogo.

TemplateData za Convert

Converts measurements to other units.

Template parameters


the value to convert

from unit2

to units3

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


show “on” unit symbols, “off” all unit names in full words, “in” abbreviated input units, “out” abbreviated output units or “values” no unit names


“us” US


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


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

significant figuressigfig

number that sets the number of significant figures

sort keysortable

“on” generate a hidden sort key


See also

Predloga:Math templates