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

 * 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)
 * fluid scruples (f℈, fluid scruple, fl scruple, fl. scruple, f scruple, f. scruple, fluid scruples, fl scruples, fl. scruples, f scruples, f. scruples)
 * minims (min, minim, minims)
 * 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)
 * scruples (℈, scruple, scruples)
 * grains (gr, grain, grains)
 * 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.


 * variant: Optional. Not shown above. Set this to apot to display certain units in the apothecaries' system notation. If using for units of mass, the conversion values for pounds, ounces, and drams will follow the apothecaries' system. Note that those values are different from the avoirdupois system, which is assumed to be the default if this parameter is left blank.


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