CONVERT Function
The CONVERT function is one of the engineering functions. It is used to convert a number from one measurement system to another. For example, CONVERT can translate a table of distances in miles to a table of distances in kilometers.
Syntax
CONVERT(number, from_unit, to_unit)
The CONVERT function has the following arguments:
| Argument |
Description |
| number |
The value to be converted. |
| from_unit |
The original measurement unit. A text string enclosed in quotes. The possible values are listed in the table below. |
| to_unit |
The measurement unit that the number should be converted to. A text string enclosed in quotes. The possible values are listed in the table below. |
Weight and mass
| Unit |
Text value |
| Gram |
"g" |
| Slug |
"sg" |
| Pound mass (avoirdupois) |
"lbm" |
| U (atomic mass unit) |
"u" |
| Ounce mass (avoirdupois) |
"ozm" |
| Grain |
"grain" |
| U.S. (short) hundredweight |
"cwt" or "shweight" |
| Imperial hundredweight |
"uk_cwt" or "lcwt" ("hweight") |
| Stone |
"stone" |
| Ton |
"ton" |
| Imperial ton |
"uk_ton" or "LTON" ("brton") |
Distance
| Unit |
Text value |
| Meter |
"m" |
| Statute mile |
"mi" |
| Nautical mile |
"Nmi" |
| Inch |
"in" |
| Foot |
"ft" |
| Yard |
"yd" |
| Angstrom |
"ang" |
| Ell |
"ell" |
| Light-year |
"ly" |
| Parsec |
"parsec" or "pc" |
| Pica (1/72 inch) |
"Picapt" or "Pica" |
| Pica (1/6 inch) |
"pica" |
| U.S survey mile (statute mile) |
"survey_mi" |
Time
| Unit |
Text value |
| Year |
"yr" |
| Day |
"day" or "d" |
| Hour |
"hr" |
| Minute |
"mn" or "min" |
| Second |
"sec" or "s" |
Pressure
| Unit |
Text value |
| Pascal |
"Pa" (or "p") |
| Atmosphere |
"atm" (or "at") |
| mm of Mercury |
"mmHg" |
| PSI |
"psi" |
| Torr |
"Torr" |
Force
| Unit |
Text value |
| Newton |
"N" |
| Dyne |
"dyn" (or "dy") |
| Pound force |
"lbf" |
| Pond |
"pond" |
Energy
| Unit |
Text value |
| Joule |
"J" |
| Erg |
"e" |
| Thermodynamic calorie |
"c" |
| IT calorie |
"cal" |
| Electron volt |
"eV" (or "ev") |
| Horsepower-hour |
"HPh" (or "hh") |
| Watt-hour |
"Wh" (or "wh") |
| Foot-pound |
"flb" |
| BTU |
"BTU" (or "btu") |
Power
| Unit |
Text value |
| Horsepower |
"HP" (or "h") |
| Pferdestärke |
"PS" |
| Watt |
"W" (or "w") |
Magnetism
| Unit |
Text value |
| Tesla |
"T" |
| Gauss |
"ga" |
Temperature
| Unit |
Text value |
| Degree Celsius |
"C" (or "cel") |
| Degree Fahrenheit |
"F" (or "fah") |
| Kelvin |
"K" (or "kel") |
| Degrees Rankine |
"Rank" |
| Degrees Réaumur |
"Reau" |
Volume (or l iquid measure )
| Unit |
Text value |
| Teaspoon |
"tsp" |
| Modern teaspoon |
"tspm" |
| Tablespoon |
"tbs" |
| Fluid ounce |
"oz" |
| Cup |
"cup" |
| U.S. pint |
"pt" (or "us_pt") |
| U.K. pint |
"uk_pt" |
| Quart |
"qt" |
| Imperial quart (U.K.) |
"uk_qt" |
| Gallon |
"gal" |
| Imperial gallon (U.K.) |
"uk_gal" |
| Liter |
"l" or "L" ("lt") |
| Cubic angstrom |
"ang3" or "ang^3" |
| U.S. oil barrel |
"barrel" |
| U.S. bushel |
"bushel" |
| Cubic feet |
"ft3" or "ft^3" |
| Cubic inch |
"in3" or "in^3" |
| Cubic light-year |
"ly3" or "ly^3" |
| Cubic meter |
"m3" or "m^3" |
| Cubic Mile |
"mi3" or "mi^3" |
| Cubic yard |
"yd3" or "yd^3" |
| Cubic nautical mile |
"Nmi3" or "Nmi^3" |
| Cubic Pica |
"Picapt3", "Picapt^3", "Pica3" or "Pica^3" |
| Gross Registered Ton |
"GRT" ("regton") |
| Measurement ton (freight ton) |
"MTON" |
Area
| Unit |
Text value |
| International acre |
"uk_acre" |
| U.S. survey/statute acre |
"us_acre" |
| Square angstrom |
"ang2" or "ang^2" |
| Are |
"ar" |
| Square feet |
"ft2" or "ft^2" |
| Hectare |
"ha" |
| Square inches |
"in2" or "in^2" |
| Square light-year |
"ly2" or "ly^2" |
| Square meters |
"m2" or "m^2" |
| Morgen |
"Morgen" |
| Square miles |
"mi2" or "mi^2" |
| Square nautical miles |
"Nmi2" or "Nmi^2" |
| Square Pica |
"Picapt2", "Pica2", "Pica^2" or "Picapt^2" |
| Square yards |
"yd2" or "yd^2" |
Information
| Unit |
Text value |
| Bit |
"bit" |
| Byte |
"byte" |
Speed
| Unit |
Text value |
| Admiralty knot |
"admkn" |
| Knot |
"kn" |
| Meters per hour |
"m/h" or "m/hr" |
| Meters per second |
"m/s" or "m/sec" |
| Miles per hour |
"mph" |
It's also possible to use prefixes with the from_unit and to_unit values, e.g. if you add the "k" prefix before the "g" unit, you'll get the "kg" value that denotes kilograms.
Prefixes
| Prefix |
Multiplier |
Text value |
| yotta |
1E+24 |
"Y" |
| zetta |
1E+21 |
"Z" |
| exa |
1E+18 |
"E" |
| peta |
1E+15 |
"P" |
| tera |
1E+12 |
"T" |
| giga |
1E+09 |
"G" |
| mega |
1E+06 |
"M" |
| kilo |
1E+03 |
"k" |
| hecto |
1E+02 |
"h" |
| dekao |
1E+01 |
"da" or "e" |
| deci |
1E-01 |
"d" |
| centi |
1E-02 |
"c" |
| milli |
1E-03 |
"m" |
| micro |
1E-06 |
"u" |
| nano |
1E-09 |
"n" |
| pico |
1E-12 |
"p" |
| femto |
1E-15 |
"f" |
| atto |
1E-18 |
"a" |
| zepto |
1E-21 |
"z" |
| yocto |
1E-24 |
"y" |
Binary Prefixes
| Prefix |
Prefix value |
Text value |
| yobi |
2^80 = 1 208 925 819 614 629 174 706 176 |
"Yi" |
| zebi |
2^70 = 1 180 591 620 717 411 303 424 |
"Zi" |
| exbi |
2^60 = 1 152 921 504 606 846 976 |
"Ei" |
| pebi |
2^50 = 1 125 899 906 842 624 |
"Pi" |
| tebi |
2^40 = 1 099 511 627 776 |
"Ti" |
| gibi |
2^30 = 1 073 741 824 |
"Gi" |
| mebi |
2^20 = 1 048 576 |
"Mi" |
| kibi |
2^10 = 1024 |
"ki" |
Notes
The from_unit and to_unit arguments must be compatible, i.e. they should belong to the same measurement type.
How to apply the CONVERT function.
Examples
The figure below displays the result returned by the CONVERT function.
Return to previous page