Template:Convert/doc

Template convert calculates measurements from one unit (you entered) to another one, and then presents the results. For example:
 * &rarr; 1 km
 * &rarr; 7 mi

That's all.

Unit name or abbreviation (symbol): 1 pound or 1 lb?
on will produce the unit's symbol:
 * &rarr; 1 lb
 * &rarr; 1 lb

Adjective: a 10-mile distance
Use on to produce the adjective form. The difference:
 * &rarr; 10 mi to go. -- Regular
 * &rarr; A 10 mi distance. -- Adjective

Rounding: 123 ft is 40 m or 37 m or 37.5 m?
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 $1/undefined$ 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  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.

Range of values: 6 to 17 kg (13 to 37 lb)
Range indicators are entered as the second parameter (between the values). Range separators can be:
 * ,  (ndash or hyphen),  ,  ,  ,  :
 * &rarr; 6 to 17 kg
 * &rarr; -10 to -20 C
 * &rarr; 6 and 17 kg
 * &rarr; 6 to(-)
 * &rarr; 60 +/-

Multiple dimensions: 6 by 12 feet (1.8 by 3.7 m)

 * &rarr; 6 by
 * &rarr; 6 x

Brackets and separators: 2.4 m, 7.9 ft
Brackets and separators are set by disp:
 * &rarr; 2.4 m -- default
 * &rarr; 2.4 m
 * &rarr; 2.4 m
 * &rarr; 2.4 m
 * &rarr; 2.4 m

Spelling of units: UK metre or US meter?
Default spelling of units is en-UK. To show en-US spelling, use us:
 * &rarr; 1 m -- default
 * &rarr; 1 m

Spell out numbers: ten miles
To write a number in words, use in:
 * &rarr; 10 mi

To spell out both in and out values, use on:
 * &rarr; 10 mi

To make first letter a capital, use In, On
 * &rarr; 10 mi
 * &rarr; 10 mi

Remember that the spelling of the units (ft, m) is independently set by abbr. To the extreme:
 * &rarr; 10 mi

Extra words: 4 planted acres

 * Incomplete secion:
 * &rarr; 4 acre

Tables: sorting, ...

 * Sorting
 * Use table and on} to produce code:
 * 10 m

Parameter list
Examples of number grouping:
 * → 1234 m
 * → 1234 m
 * → 12345 m
 * → 1234 m
 * → 1234 m
 * → 123,456,789 m

Examples of spelling input values:
 * → 10 mi
 * → 10 mi
 * → 1/3 mi

Free text in a range: 12 m but not greater than 14 m
The range-indicator options like – are limited to a list (see above). It might be needed to use &lt;any text> in a conversion situation, to get a result like:

convert does not have this option. One can use variant templates:
 * &rarr;

For these situations, see the documentation of:
 * convert/2
 * convert/3
 * convert/4

TemplateData
{ "description": "Converts measurements to other units.", "params": { "1": { "label": "value", "description": "the value to convert", "type": "number" }, "2": { "label": "from unit", "description": "", "type": "string/line" }, "3": { "label": "to units", "description": "", "type": "string/line" }, "4": { "label": "precision or suffix", "description": "significant digits after decimal dot or, if negative, exponent of ten", "type": "number" }, "lk": { "label": "link units", "description": "“on” all, “in” input, “out” output or “off” no units", "default": "off", "type": "string/line" }, "abbr": { "label": "abbreviation", "description": "show “on” unit symbols, “off” all unit names in full words, “in” abbreviated input units, “out” abbreviated output units or “values” no unit names", "type": "string/line" }, "sp": { "label": "spelling", "description": "“us” US", "type": "string/line" }, "adj": { "label": "adjective", "description": "adjective form (singular unit name appended by hyphen) “on” or “mid” to put conversion at end", "type": "string/line" }, "disp": { "label": "conversion", "description": "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", "default": "b", "type": "string/line" }, "sigfig": { "label": "significant figures", "description": "number that sets the number of significant figures", "type": "number" }, "sortable": { "label": "sort key", "description": "“on” generates a hidden sort key", "type": "string/line" } }}