Template:SIrange/doc

This template displays a range of values given in US Customary Units and converts it to the corresponding SI (metric) units. Its syntax is similar to the SI template, except that it does not support output in long form and needs two numbers as required input. It accepts a wide array of abbreviations and standardizes the output for both units.

For units that do not have an official abbreviation, such as leagues and fathoms, the displayed unit will always be given in plural form.

Usage

 * value1, value2: Required. The numerical values in the original unit. Positive, negative, and zero values are accepted.
 * unit: Required. The original unit. Supported values are:
 * Units of length:
 * inches (accepted abbreviations: in, inch, inches, in., ")
 * feet (ft, feet, foot, ft.,  ' )
 * yards (yd, yard, yards, yd.)
 * miles (mi, mile, miles, mi.)
 * leagues (league, leagues)
 * fathoms (fathom, fathoms)
 * nautical miles (M, NM, nmi, nm)
 * feet and inches (ft-in,  '" ): in this case, the value field must be in the format x'y or x'y", where x and y are numerical values. See the examples below.
 * Units of area:
 * square inches (sq. in, square inch, square inches, square in, sq inches, sq inch, sq in, in², in2)
 * square feet (sq. ft, sq ft, sf, ft², ft2)
 * square yards (sq. yd, sq yd, yd², yd2)
 * square miles (sq. mi, sq mi, mi², mi2)
 * acres (acre, acres)
 * Units of volume:
 * cubic inches (cu. in, cubic inch, cubic inches, cubic in, cu inch, cu in, cui, CI, c.i., in³, in3)
 * Cubic feet (cu. ft, cubic feet, cubic foot, cubic ft, cu feet, cu foot, cu ft, cu.ft, cuft, cb ft, cb.ft, cbft, cbf, feet³, foot³, ft³, ft3)
 * cubic yards (cu yd, cubic yard, cubic yards, yd³, yd3)
 * fluid ounces (fl. oz, fl oz, fl. oz., oz. fl.)
 * pints (pt, pint, pints)
 * quarts (qt, quart, quarts)
 * gallons (gal, gallon, gallons)
 * US bushels (bsh, bu, bushel, bushels)
 * fluid drams (fl dr, fl. dr, fl dr., fʒ, f ʒ, fluid drachm, fluidram, fluidrachm, fluid dram, fluid drams)
 * Units of mass:
 * pounds (lb, lb., lbs, lbs., pound, pounds)
 * ounces (oz, oz., ounce, ounces)
 * short tons (ton, tons)
 * drams (dr, dr., ʒ, drachm, dram, drams)
 * Units of temperature:
 * degrees Fahrenheit (F, °F, ℉, degrees F, degree F)


 * prefix: Optional. The desired SI prefix for the output. The template defaults to a unit with no prefix (such as meter, gram, cubic meter, etc.), but this can be overriden by selecting an appropriate prefix. Valid options are:
 * m
 * c
 * d
 * da
 * h
 * k
 * Additionally, the template is capable of converting volume to liters and milliliters if the user chooses from the prefixes l, L ml, or mL. It will result in an error message if it attempts to convert a non-volume quantity.
 * This parameter will be ignored if converting temperatures.


 * long: Optional. Not shown above. Set this to any value (typically yes) to have the output displayed in long form without abbreviating units.