قالب:Convert/doc
هذه صفحة توثيق فرعية لـ قالب:Convert. تتضمن معلومات الاستعمال، التصنيفات وأي محتوى آخر ليس من محتويات الأصل لصفحة القالب. |
This project or template has a transwiki guide to help editors adapt it to a remote wiki when this cannot be done by simply copying the codes of one single template. See قالب:Convert/doc/Transwiki guide for instructions. |
Uses Lua: |
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 kilometres (1.2 mi){{convert|7|mi|km}}
→ 7 miles (11 km)
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 symbols (= abbreviation).
Use |abbr=on/off
to change this behaviour:
{{convert|1|lb|kg}}
→ 1 pound (0.45 kg) (To compare; default: first value shows unit name){{convert|1|lb|kg|abbr=on}}
→ 1 lb (0.45 kg){{convert|1|lb|kg|abbr=off}}
→ 1 pound (0.45 kilograms)
|abbr=in
toggles the default behaviour (|abbr=out
):
{{convert|1|lb|kg|abbr=in}}
→ 1 lb (0.45 kilograms)
Adjective: a 10-mile distance
Use |adj=on
to produce the adjective form. The difference:
{{convert|10|mi|km}} to go
→ 10 miles (16 km) to go. (To compare, default)A {{convert|10|mi|km|adj=on}} distance
→ A 10-mile (16 km) distance. (Adjective form)
Rounding: 100 ft is 30 m or 30.5 m or 30.48 m?
By definition, 100 ft equals 30,480 mm. 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 feet (40 m) | |
{{convert|123|ft|m|0}} | 123 feet (37 m) | |
{{convert|123|ft|m|1}} | 123 feet (37.5 m) | |
{{convert|550|ft|m|0}} | 550 feet (168 m) | Approximate value is 167.64 m |
{{convert|550|ft|m}} | 550 feet (170 m) | Rounds to 170, when approximate value is 167.64 m |
{{convert|500|ft|m|0}} | 500 feet (152 m) | Approximate value is 152.4 m |
{{convert|500|ft|m}} | 500 feet (150 m) | Rounds to 150, when approximate value is 152.4 m |
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 1⁄10 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: use |sigfig=
To specify the output number to be with n significant figures use |sigfig=<number>
:
- To compare: {{convert|1200|ft|m}} → 1,200 feet (370 m)
- {{convert|1200|ft|m|sigfig=4}} → 1,200 feet (365.8 m)
- {{convert|1200|ft|m|sigfig=3}} → 1,200 feet (366 m)
- {{convert|1200|ft|m|sigfig=2}} → 1,200 feet (370 m)
- {{convert|1200|ft|m|sigfig=1}} → 1,200 feet (400 m)
Setting |sigfig=
is meaningless
- {{convert|1200|ft|m|sigfig=0}} → 1,200 feet (370 m)*
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 metres (33 ft){{convert|10|m|ft|round=5}}
→ 10 metres (35 ft)
Similar: using |round=25
rounds the outcome to a multiple of 25.
{{convert|10|m|ft}}
→ 10 metres (33 ft){{convert|10|m|ft|round=25}}
→ 10 metres (25 ft)- To compare:
{{convert|10|m|ft|sigfig=4}}
→ 10 metres (32.81 ft)
In a range, one can round each value individually to the default. Use |round=each
:
{{convert|10 x 200 x 3000|m|ft}}
→ 10 by 200 by 3,000 metres (33 ft × 656 ft × 9,843 ft){{convert|10 x 200 x 3000|m|ft|round=each}}
→ 10 by 200 by 3,000 metres (33 ft × 660 ft × 9,800 ft)
Round to a multiple of a given fraction: 23⁄16 inch
Specify the desired denominator using |frac=<some positive integer>
. (Denominator is the below-the-slash number, for example the 3 in 1⁄3).
{{convert|5.56|cm|in|frac=16}}
→ 5.56 centimetres (2+3⁄16 in){{convert|8|cm|in|frac=4}}
→ 8 centimetres (3+1⁄4 in)
The fraction is reduced when possible:
{{convert|8|cm|in|frac=100}}
→ 8 centimetres (3+3⁄20 in){{convert|8|cm|in}}
→ 8 centimetres (3.150 in) (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 K)
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 K)
Into multiple units: 10 °C (50 °F; 283 K)
Separate the multiple output units by a space:
{{convert|10|C|F K}}
→ 10 °C (50 °F; 283 K){{convert|5|km|mi nmi}}
→ 5 kilometres (3.1 mi; 2.7 nmi)- 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 feet (0.91–1.83 m) | Input can be hyphen (-) or en dash (–), output uses en dash |
– – (en dash)
|
{{convert|3|–|6|ft}}
|
3–6 feet (0.91–1.83 m) | |
and
|
{{convert|3|and|6|ft}}
|
3 and 6 feet (0.91 and 1.83 m) | |
&
|
{{convert|3|&|6|ft}}
|
3 &[convert: unknown unit] | Same as and
|
and(-)
|
{{convert|3|and(-)|6|ft}}
|
3 and 6 feet (0.91–1.83 m) | |abbr=on abbreviates the first unit
|
and(-)|abbr=on
|
{{convert|3|and(-)|6|ft|abbr=on}}
|
3 and 6 ft (0.91–1.83 m) | |
or
|
{{convert|3|or|6|ft}}
|
3 or 6 feet (0.91 or 1.83 m) | |
to
|
{{convert|3|to|6|ft}}
|
3 to 6 feet (0.91 to 1.83 m) | |
to(-)
|
{{convert|3|to(-)|6|ft}}
|
3 to 6 feet (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) | |
to about
|
{{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|+|6|ft}}
|
3 + 6 feet (0.91 + 1.83 m) | |
,
|
{{convert|3|,|6|ft}}
|
3, 6 feet (0.91, 1.83 m) | |
, and
|
{{convert|3|, and|6|ft}}
|
3, and 6 feet (0.91, and 1.83 m) | |
, or
|
{{convert|3|, or|6|ft}}
|
3, or 6 feet (0.91, or 1.83 m) | |
by
|
{{convert|3|by|6|ft}}
|
3 by 6 feet (0.91 by 1.83 m) | |
x
|
{{convert|3|x|6|ft}}
|
3 by 6 feet (0.91 m × 1.83 m) | Scientific notation.|abbr=on abbreviates the first unit
|
× ×
|
{{convert|3|×|6|ft}}
|
3 by 6 feet (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 |
Multiple dimensions: 6 m × 12 m (20 ft × 39 ft)
- Use "by"
{{convert|6|by|12|ft|m}}
→ 6 by 12 feet (1.8 by 3.7 m)- Use "×" or ""x""
{{convert|6|x|12|m|ft}}
→ 6 by 12 metres (20 ft × 39 ft)
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 m × 12 m (20 ft × 39 ft)
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:
{{convert|1|ft|3|in|mm}}
→ 1 foot 3 inches (380 mm) (to compare){{convert|1|ft|3|in|x|3|ft|5|in|mm}}
→ 1 foot 3 inches ([convert: unknown unit])*
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 metre (3.3 ft) -- default{{convert|1|m|ft|sp=us}}
→ 1 meter (3.3 ft)
Spell out numbers: ten miles
To write a number in words, use |spell=in
:
{{convert|10|mi|m|spell=in}}
→ ten miles (16,000 m)
To spell out both in and out values, use |spell=on
:
{{convert|10|mi|m|spell=on}}
→ ten miles (sixteen thousand metres)
To make first letter a capital, use |spell=In
, |spell=On
{{convert|10|mi|m|spell=In}}
→ Ten miles (16,000 m){{convert|10|mi|m|spell=On}}
→ Ten miles (sixteen thousand metres)
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 miles (sixteen thousand meters)
Extra words: 4 planted acres
- Incomplete section
{{convert|4|acre||adj=pre|planted}}
→ 4 planted acres (1.6 ha)
Extra adjective words: A 10-foot-long corridor
{{convert|4|ft|m|adj=mid|-long}}
→ 10-foot-long (3.0 m)
Plurals: 1 inch, 2 inches
The unit symbol is singular always. Depending on the preceding number only, a unit name can be shown plural.
{{convert|1|metre}}
→ 1 metre (3 ft 3 in){{convert|2|metre}}
→ 2 metres (6 ft 7 in){{convert|2|metre|abbr=on}}
→ 2 m (6 ft 7 in)
- Exception
Entering the unit spelled |foot|
forces singular output "foot", whatever the number is.
{{convert|100|foot|abbr=off}}
→ 100 foot (30 metres)
Changes to 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 (and some others you might want to use) 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 Show Preview (or Save Page):
- → had 18, 24, 32 pounds (8, 11, 15 kg) 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 Show Preview. The preview will show the converted numbers are still correct:
- → had 18, 24, 32 pounds (8, 11, 15 kg) cannons
- Then click Save Page.
- 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, 24, 32 pounds (8, 11, 15 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, 11_and_15 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)
السوابق المترية
النص
الرمز
المعامل
yotta
Y
1024
zetta
Z
1021
exa
E
1018
peta
P
1015
tera
T
1012
giga
G
109
mega
M
106
kilo
k
103
hecto
h
102
deca
da
101
(none)
(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 Gm (1.2×1010 m)
- 12 μm (1.2×10−5 m)
The prefix can be added before the SI unit (here: unit m
for meter):
{{convert|12|Gm|mi|abbr=on}}
→ 12 Gm (7,500,000 mi)
Mm
: 12 Mm (7,500 mi)
km
: 12 km (39,000 ft)
mm
: 12 mm (0.47 in)
μm
: 12 μm (0.012 mm)
um
: 12 μm (0.012 mm) (letter "u" can be used for "μ" here)
The prefix can be used in the output unit:
{{convert|12000|mi|Mm|abbr=on}}
→ 12,000 mi (19 Mm)
{{convert|12|in|μm|abbr=on}}
→ 12 in (300,000 μm)
As an exception, the non-SI unit "inch" can have the "μ" prefix too)
{{convert|12|μm|μin|abbr=on}}
→ 12 μm (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 million metres (23,000,000 ft)
The same is possible for the output unit:
{{convert|23,000,000|ft|e6m}}
→ 23,000,000 feet (7.0×10 6 m)
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+1⁄2 inches (38.1 mm)
The number to convert can be written in fractions. Both /
(keyboard slash) and ⁄
(fraction slash) are accepted:
{{convert|1/2|in|mm|1}} → 1⁄2 inch (12.7 mm)
{{convert|1⁄2|in|mm|1}} → 1⁄2 inch (12.7 mm)
With integers, use a +
sign
{{convert|2+1⁄2|in|mm|1}} → 2+1⁄2 inches (63.5 mm)
When negative, use a hyphen -
and repeat it:
{{convert|-2-1⁄2|in|mm|1}} → −2+1⁄2 inches (−63.5 mm)
{{convert|2-1⁄2|in|mm|1}} → 2–1⁄2 inch (50.8–12.7 mm) Note: this is read as a range
{{convert|-2+1⁄2|in|mm|1}} → [convert: invalid number] 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 inch (12.7 mm)
{{convert|2+1//2|in|mm|1}}
→ 2+1/2 inches (63.5 mm)
Thousands separator: 1,000 mi and 1000 mi
In input, a comma for thousands separator is accepted. A gap (space) is not. In output, by default, the thousand separator is the comma:
{{convert|1,234,567|m|ft}}
→ 1,234,567 metres (4,050,417 ft)
{{convert|1,234,567|m|ft}}
→ 1,234,567 metres (4,050,417 ft)
{{convert|1 234 567|m|ft}}
→ [convert: invalid number]
Set |comma=off
to remove the separator:
{{convert|1234567|m|ft|comma=off}}
→ 1,234,567 metres (4,050,417 ft)*
Use |comma=gaps
to set digit grouping by gap (<space>
) in larger numbers (thousands separator):
{{convert|1234567|m|ft}}
→ 1,234,567 metres (4,050,417 ft) (To compare, default)
{{convert|1234567|m|ft|comma=gaps}}
→ 1234567 metres (4050417 ft)
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 metres (4,049 ft) (To compare, default)
{{convert|1234|m|ft|comma=5}}
→ 1234 metres (4049 ft)
{{convert|1234567|m|ft|comma=5}}
→ 1,234,567 metres (4,050,417 ft)
{{convert|1234|m|ft|comma=gaps5}}
→ 1,234 metres (4,049 ft)*
{{convert|1234567|m|ft|comma=gaps5}}
→ 1,234,567 metres (4,050,417 ft)*
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 metres (33 ft) -- ( ) brackets are the default
{{convert|10|m|ft|disp=sqbr}}
→ 10 metres [33 ft]
{{convert|10|m|ft|disp=comma}}
→ 10 metres, 33 ft
{{convert|10|m|ft|disp=or}}
→ 10 metres or 33 feet
Setting |disp=br
will force a new line (<br>
)
{{convert|10|m|ft|disp=br}}
→ 10 metres
33 feet
Also |disp=br()
will force a new line, and keep the brackets:
{{convert|10|m|ft|disp=br()}}
→ 10 metres
(33 feet)
Setting |disp=x|...
allows any text as separator:
{{convert|10|m|ft|disp=x|_MyText_}}
→ 10 metres_MyText_33 ft -- (To display spaces, use
)
Flipping (reordering) the two measurements: 1,609.3 metres (1 mile)
Setting |order=flip
will flip (swap) the two measurements:
{{convert|1|mi|m}}
→ 1 mile (1,609.3 metres) (To compare, default)
{{convert|1|mi|m|order=flip}}
→ 1,609.3 metres (1 mile)
When converting to multiple units, the effect is:
{{convert|10|km|mi nmi|order=flip}}
→ 6.2137 miles; 5.3996 nautical miles (10 kilometres)
{{convert|10|km|nmi mi|order=flip}}
→ 5.3996 nautical miles; 6.2137 miles (10 kilometres)
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 cubic yards (1.5 m3)
Default, to compare
{{convert|2|cuyd|m3|abbr=values}}
2 (1.5)
Input and output numbers
{{convert|2|cuyd|m3|disp=unit}}
cubic yards
Input unit
{{convert|2|cuyd|m3|disp=unit|adj=on}}
cubic-yard
Input unit, adjective (hyphenated)
{{convert|2|cuyd|cuyd|0|disp=out|abbr=off}}
2 cubic yards
Input (workaround)
{{convert|2|cuyd|m3|abbr=~}}
2 cubic yards [cu yd] (1.5 m3)
Input: both name and symbol
{{convert|2|cuyd|m3|disp=unit2}}
m3
Output unit (symbol)
{{convert|2|cuyd|m3|disp=unit2|abbr=off}}
cubic metres
Output unit (name)
{{convert|2|cuyd|m3|disp=number}}
1.5
Output value
{{convert|2|cuyd|m3|disp=out}}
1.5 m3
Output value and unit
{{convert|2|cuyd|m3|disp=out|abbr=off}}
1.5 cubic metres
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 kilopascals [kPa] (0.29 psi)
A {{convert|2|kPa|psi|abbr=~|adj=on}} pressure
→ A 2-kilopascal [kPa] (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 kilometres
62 miles
100 kilometres
(62 miles)
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 metres (98 ft)
Sorting
- Use both
|disp=table
|sortable=on
to produce table columns (pipe symbols), with sortable table column.
- {{convert|10|m|ft|disp=table|sortable=on}} →
style="text-align:right;" data-sort-value="7001100000000000000"|10
|style="text-align:right;" data-sort-value="7001100000000000000"|33
m
ft
A
15+3⁄4
52
B
15.5
51
C
16.0
52.5
D
16
52
- Technical background
- The option adds the hidden numerical sortkey.
<span style="display:none">7001100000000000000</span>10
Units
See also: complete Convert/list of units
القائمة المختصرة للوحدات التي يتعامل معها {{Convert}}
الـشـرح
النظام
الوحدة
كود
(بديل)
الاختصار
ملاحظات
معامل التحويل
توافيق
the system(s) to which the unit belongs
units listed by name
codes that can be entered when using the template
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
Length
(Full list)
system
unit
code
(alternative)
abbreviation
notes
conversion factor/m
combinations
SI
مـِگامترre
Mm
Mm
US spelling: megameter
1٬000٬000
كيلومتر
km
كم
US spelling: kilometer
1٬000
- km mi
metre
m
m
US spelling: meter
1
- m ft
- m ftin
centimetre
cm
cm
US spelling: centimeter
0٫01
- cm in
ميليمتر
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
assumes 1 fathom ≡ 6 ft
1٫8288
yard
yd
yd
assumes the international definition
0٫9144
foot
ft (foot)
ft
The foot code will produce foot as the plural form.
0٫3048
- ft m (foot m)
inch
in
in
0٫0254
- in cm
- in mm
Other
nautical mile
nmi
nmi
the international standard nautical mile
For other nautical miles see the full list.
1٬852
فرسخ فلكي
pc
pc
30٫856775813057000×1015
سنة ضوئية
ly
ly
9٫460730472580800×1015
وحدة فلكية
AU
AU
149٬597٬870٬700
المساحة
(Full list)
النظام
الوحدة
الكود
(بديل)
الاختصار
هامش
معامل التغيير/م²
توافيق
SI
square kilometre
sqkm
km²
US spelling: square kilometer
1٬000٬000
- sqkm sqmi
square metre
sqm
m²
US spelling: square meter
1
- sqm sqft
square centimetre
sqcm
cm²
US spelling: square centimeter
0٫0001
- sqcm sqin
square millimetre
sqmm
mm²
US spelling: square millimeter
0٫000001
- sqmm sqin
non-SI metric
هكتار
ha
هك
10٬000
Imperial
&
US customary
ميل مربع
sqmi
ميل²
2٬589٬988٫110336
- sqmi sqkm
فدان
acre
acres
4٬046٫856422
square yard
sqyd
sq yd
0٫83612736
قدم مربع
sqft
(sqfoot)
sq ft
The sqfoot code will produce square foot as the plural form.
0٫09290304
- sqft sqm (sqfoot sqm)
square inch
sqin
sq in
0٫00064516
- sqin sqcm
Other
square nautical mile
sqnmi
sq nmi
3٬429٬904
دونم
dunam
For alternative spellings and definitions see the full list
1٬000
tsubo
tsubo
坪
(400/121)
Volume
(Full list)
system
unit
code
(alternative)
abbreviation
notes
conversion factor/m³
combinations
SI
cubic metre
cum
m³
US spelling: cubic meter
one kilolitre
1
cubic centimetre
cucm
cm³
US spelling: cubic centimeter
one millilitre
0٫000001
cc
cc
cubic millimetre
cumm
mm³
US spelling: cubic millimeter
0٫000000001
non-SI metric
kilolitre
kl
kl
US spelling: kiloliter
one cubic metre
1
kL
kL
litre
l
l
US spelling: liter
one cubic decimetre
Triple combinations are also possible. See the full list.
0٫001
- l impgal
- l USgal
- l U.S.gal
- l USdrygal
- l U.S.drygal
L
L
- L impgal
- L USgal
- L U.S.gal
- L USdrygal
- L U.S.drygal
centilitre
cl
cl
US spelling: centiliter
0٫00001
cL
cL
millilitre
ml
ml
US spelling: milliliter
one cubic centimetre
0٫000001
- ml impoz
- ml USoz
- ml U.S.oz
mL
mL
- mL impoz
- mL USoz
- mL U.S.oz
Imperial
&
US customary
ياردة مكعبة
cuyd
cu yd
0٫764554857984
قدم مكعب
cuft (cufoot)
ق3
The cufoot code will produce cubic foot as the plural form.
0٫028316846592
cubic inch
cuin
cu in
0٫000016387064
Imperial
barrel
impbbl
imp bbl
36 imp gal
0٫16365924
bushel
impbsh
imp bsh
8 imp gal
0٫03636872
impbu
imp bu
gallon
impgal
imp gal
4.54609 litres by definition, also
4 imp qt or 8 imp pt or 160 imp fl oz
Triple combinations are also possible. See the full list.
0٫00454609
- impgal l
- impgal L
- impgal USgal
- impgal U.S.gal
- impgal USdrygal
- impgal U.S.drygal
quart
impqt
imp qt
1/4 imp gal or 40 imp fl oz
0٫0011365225
pint
imppt
imp pt
1/8 imp gal or 20 imp fl oz
0٫00056826125
imperial fluid ounce
impoz (impfloz)
imp fl oz
1/160 imp gal
0٫0000284130625
- impoz USoz
- impoz U.S.oz
- impoz ml
- impoz mL
US customary
liquid measure
barrel
USbbl
US bbl
31½ US gal
used for liquids except for oil and beer (see the full list)
0٫119240471196
U.S.bbl
U.S. bbl
برميل
oilbbl
bbl
42 US gal
0٫158987294928
beer barrel
USbeerbbl
(usbeerbbl)
US bbl
0٫117347765304
U.S.beerbbl
(usbeerbbl)
U.S. bbl
گالون أمريكي
USgal
گالون أمريكي
231 cubic inches by definition, also
4 US qt or 8 US pt or 128 US fl oz
Triple combinations are also possible. See the full list.
0٫003785411784
- USgal l
- USgal L
- USgal impgal
U.S.gal
U.S. gal
- USgal l
- USgal L
- USgal impgal
quart
USqt
US qt
1/4 US gal or 32 US fl oz
0٫000946352946
U.S.qt
U.S. qt
pint
USpt
US pt
1/8 US gal or 16 US fl oz
0٫000473176473
U.S.pt
U.S. pt
fluid ounce
USoz
(USfloz)
US fl oz
1/128 US gal
0٫0000295735295625
- USoz ml
- USoz mL
- USoz impoz
U.S.oz
(U.S.floz)
U.S. fl oz
- U.S.oz ml
- U.S.oz mL
- U.S.oz impoz
US customary
dry measure
barrel
USdrybbl
US bbl
105/32 US bsh
0٫11562819898508
U.S.drybbl
U.S. dry bbl
bushel
USbsh
US bsh
2150.42 cubic inches by definition
0٫03523907016688
USbu
U.S. bu
U.S.bsh
U.S. bsh
U.S.bu
U.S. bu
dry gallon
USdrygal
US dry gal
1/8 US bsh
Triple combinations are also possible. See the full list.
0٫00440488377086
- 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
dry quart
USdryqt
US dry qt
1/32 US bsh
0٫001101220942715
U.S.dryqt
U.S. dry qt
dry pint
USdrypt
US dry pt
1/32 US bsh
0٫0005506104713575
U.S.drypt
U.S. dry pt
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
كيلومتر/ساعة
km/h
كم/س
(5/18)
- km/h mph
Imperial
&
US customary
ميل في الساعة
mph
ميل/س
0٫44704
- mph km/h
قدم/ثانية
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
عقدة
kn (knot)
عقدة
(4٫63/9)
Force
(Full list)
system
unit
code
(alternative)
abbreviation
notes
conversion factor/N
combinations
SI
گيگانيوتن
GN
GN
Triple combinations are also possible. See the full list.
1٬000٬000٬000
- GN LT-f
- GN LTf
- GN L/T-f
- GN L/Tf
- GN ST-f
- GN STf
- GN S/T-f
- GN S/Tf
مـِگانيوتن
MN
MN
Triple combinations are also possible. See the full list.
1٬000٬000
- MN LT-f
- MN LTf
- MN L/T-f
- MN L/Tf
- MN ST-f
- MN STf
- MN S/T-f
- MN S/Tf
kilonewton
kN
kN
Triple combinations are also possible. See the full list.
1٬000
- kN LT-f
- kN LTf
- kN L/T-f
- kN L/Tf
- kN ST-f
- kN STf
- kN S/T-f
- kN S/Tf
نيوتن
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
مـِگاداين
Mdyn
Mdyn
10
kilodyne
kdyn
kdyn
0٫01
داين
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
قالب:Convert/list of units/rowaltabNa
- LTf STf
L/T-f
L/Tf
- L/T-f S/T-f
L/Tf
L/Tf
- L/Tf S/Tf
short ton-force
ST-f
STf
8٬896٫443230521
- ST-f LT-f
قالب:Convert/list of units/rowaltabNa
- STf LTf
S/T-f
S/Tf
- S/T-f L/T-f
S/Tf
S/Tf
- S/Tf L/Tf
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
Energy
(Full list)
system
unit
code
(alternative)
abbreviation
notes
conversion factor/J
combinations
SI
gigajoule
GJ
GJ
1٬000٬000٬000
مـِگاجول
MJ
MJ
1٬000٬000
kilojoule
kJ
kJ
1٬000
hectojoule
hJ
hJ
100
decajoule
daJ
daJ
10
جول
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٫600000000000000×1015
TW.h
TW·h
gigawatt-hour
GWh
GWh
3٫600000000000×1012
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
Electronvolt multiples
gigaelectronvolt
GeV
GeV
0٫0000000001602176487
megaelectronvolt
MeV
MeV
قالب:Convert/list of units/facdisp-1
kiloelectronvolt
keV
keV
قالب:Convert/list of units/facdisp-1
electronvolt
eV
eV
قالب:Convert/list of units/facdisp-1
millielectronvolt
meV
meV
قالب:Convert/list of units/facdisp-1
Calorie multiples
سعر حراري
Cal
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
رطل-قدم
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
گيگاطن من تي إن تي
GtTNT
قالب:Scinote/6
گيگاطن من تي إن تي
GtonTNT
megatonne of TNT
MtTNT
4٫184000000000000×1015
megaton of TNT
MtonTNT
Mt
kilotonne of TNT
ktTNT
4٫184000000000×1012
kiloton of TNT
ktonTNT
tonne of TNT
tTNT
4٬184٬000٬000
ton of TNT
tonTNT
Other
Hartree
Eh
Eh
قالب:Convert/list of units/facdisp-1
rydberg
Ry
Ry
قالب:Convert/list of units/facdisp-1
tonne of oil equivalent
toe
toe
41٬868٬000٬000
برميل نفط مكافئ
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
US gallon-atmosphere
USgalatm
(usgalatm)
US gal·atm
383٫5568490138
U.S.galatm
(usgalatm)
U.S. gal·atm
Temperature
(separate page; 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 سلسيوس
°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)
Mass
(Full list)
system
unit
code
(alternative)
abbreviation
notes
conversion factor/kg
combinations
SI
kilogram
kg
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
- t L/T
- t S/T
طن متري
MT
t
- MT LT
- MT ST
M/T
M/T
- M/T L/T
- M/T S/T
Avoirdupois
طن طويل
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
L/T
L/T
- L/T t
- L/T M/T
- L/T S/T
طن قصير
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
S/T
S/T
- S/T t
- S/T M/T
- S/T L/T
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
lb
Triple combinations are also possible. See the full list.
0٫45359237
- lb kg
- lb st
أوقية
oz
أوقية
0٫028349523
- oz g
درامchm
drachm
0٫001771845195
درامchm
dram
grain
gr
gr
equivalent to the troy grain
0٫00006479891
Troy
troy ounce
ozt
ozt
0٫0311034768
other
carat
carat
0٫0002
Pressure
unit
code
abbreviation
conversion factor/Pa
مـِگاپاسكال
MPa
MPa
1٬000٬000
kilopascal
kPa
kPa
1٬000
hectopascal
hPa
hPa
100
پاسكال
Pa
Pa
1
millipascal
mPa
mPa
0٫001
millibar
mbar
mbar
100
mb
mb
دسيبار
dbar
dbar
10٬000
bar
bar
bar
100٬000
kilobarye
kBa
kBa
100
باري
Ba
Ba
0٫1
standard atmosphere
atm
atm
101٬325
تور
Torr
Torr
(20٬265/152)
millimetre of mercury
mmHg
mmHg
133٫322387415
inch of mercury
inHg
inHg
3٬386٫38864341
pound per square inch
psi
psi
(444٬822٬161٫52605/64٬516)
Torque
unit
code
notes
newton metre
N·m (N.m)
Use N·m
or N.m
to get the mid-dot.
Nm
Torque conversions can go to and from the following units.
- foot-poundal
- foot-pound force
- inch-pound force
- inch-ounce force
Codes, abbreviations and conversion factors (but to N·m in this case) are the same as with the corresponding energy units as listed above.
Fuel efficency
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 yard 2 feet 3 inches (1.60 m)
{{convert|2|ft|3|in|cm}}
→ 2 feet 3 inches (69 cm)
{{convert|1|lb|5|oz|g}}
→ 1 pound 5 ounces (600 g)
In output
Available multiple-unit output options predefined, like ftin
and ydftin
. The full list is at #Output multiples.
{{convert|2|m|ftin}}
→ 2 metres (6 ft 7 in)
{{convert|2|m|ft in}}
→ 2 metres (6.6 ft; 79 in) -- using a space, returns the decimal point
{{convert|2|m}}
→ 2 metres (6 ft 7 in) -- 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}}
→ 1,000 kilograms per hectolitre (100 lb/imp gal)
Currency per unit: $/mi, $/km
Using currency symbols in a $ per unit value, you can convert the per-unit:
{{convert|10|$/mi|$/km}}
→ $10 per mile ($6.2/km)
- You can set the unit in both values using
|$=€
:
{{convert|10|$/mi|$/km|$=€}}
→ €10 per mile (€6.2/km)
You can not convert the currency. This outcome combination is not possible: $15 per mile (€8.6/km)
Parameter list
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
|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
|disp=out
out
Display only output number and name/symbol
Parts only
|disp=output only
output 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
Deprecated options
This list:
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
TemplateData
This is the TemplateData documentation for this template used by VisualEditor and other tools.
Convert
Converts measurements to other units.
وسائط القالب
وسيط وصف نوع حالة value 1
the value to convert
رقم اختياري from unit 2
سطر اختياري to units 3
the unit to convert into
سطر اختياري precision or suffix 4
significant digits after decimal dot or, if negative, exponent of ten
رقم اختياري link units lk
“on” all, “in” input, “out” output or “off” no units
- غيابي
- off
سطر اختياري abbreviation abbr
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
سطر اختياري spelling sp
“us” display U.S. spelling of unit names
سطر اختياري adjective adj
adjective form (singular unit name appended by hyphen) “on” or “mid” to put conversion at end
سطر اختياري conversion disp
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
سطر اختياري ordering order
“flip” returns converted value first, input value second.
سطر اختياري significant figures sigfig
number that sets the number of significant figures
رقم اختياري rounding output round
“5” rounds the output number to nearest multiple of 5, “25” to nearest multiple of 25, “each” rounds each number in a range
سطر اختياري thousands separator comma
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 key sortable
“on” generates a hidden sort key
سطر اختياري
See also