3.5.11.5 ConvertConvert-func
Description
Convert a number from one measurement system to another.
Syntax
double convert(double d, string str1$, string str2$)
Parameters
d
- The number to be converted from one measurement system to another.
str1$
- The unit for the number in one measurement system.
str2$
- The unit for the result in another measurement system.
Available measurement systems and units for this function are listed in the
following tables. Note that, all the units are case-sensitive.
| Units
|
Meaning
|
| "g"
|
Gram
|
| "sg"
|
Slug
|
| "lbm"
|
Pound Mass (Avoirdupois)
|
| "u"
|
U (Atomic Mass Unit)
|
| "ozm"
|
Ounce Mass (Avoirdupois)
|
| "grain"
(2019 SR0)
|
Grain
|
| "cwt" (or "shweight")
(2019 SR0)
|
U.S. (short) hundredweight
|
| "uk_cwt" or "lcwt" ("hweight")
(2019 SR0)
|
Imperial hundredweight
|
| "stone"
(2019 SR0)
|
Stone
|
| "ton"
(2019 SR0)
|
Ton
|
| "uk_ton" or "LTON" ("brton")
(2019 SR0)
|
Imperial ton
|
| Units
|
Meaning
|
| "m"
|
Meter
|
| "mi"
|
Statute Mile
|
| "Nmi"
|
Nautical Mile
|
| "in"
|
Inch
|
| "ft"
|
Foot
|
| "yd"
|
Yard
|
| "ang"
|
Angstrom
|
| "pica"
|
Pica (1/6 inch)
|
| "Pica"
|
Point (1/72 inch)
|
| "ell"
(2019 SR0)
|
ELL
|
| "ly"
(2019 SR0)
|
Light year
|
| "parsec" or "pc"
(2019 SR0)
|
Parsec
|
| "survey_mi"
(2019 SR0)
|
U.S survey mile (statute mile)
|
| Units
|
Meaning
|
| "yr"
|
Year
|
| "day"
|
Day
|
| "hr"
|
Hour
|
| "mn"
|
Minute
|
| "sec"
|
Second
|
| Units
|
Meaning
|
| "Pa" (or "p")
|
Pascal
|
| "atm" (or "at")
|
Atmosphere
|
| "mmHg"
|
mm of Mercury
|
| "psi"
|
PSI
|
| "Torr"
|
Torr
|
| Units
|
Meaning
|
| "N"
|
Newton
|
| "dyn" (or "dy")
|
Dyne
|
| "lbf"
|
Pound Force
|
| "pond"
(2019 SR0)
|
Pond
|
| Units
|
Meaning
|
| "J"
|
Joule
|
| "e"
|
Erg
|
| "c"
|
Thermodynamic Calorie (4.184 J)
|
| "cal"
|
IT Calorie (4.1868 J)
|
| "eV" (or "ev")
|
Electron Volt
|
| "HPh" (or "hh")
|
Horsepower-hour
|
| "Wh" (or "wh")
|
Watt-hour
|
| "flb"
|
Foot-pound
|
| "BTU" (or "btu")
|
BTU
|
| Units
|
Meaning
|
| "HP" (or "h")
|
Horsepower
|
| "W" (or "w")
|
Watt
|
| "PS"
(2019 SR0)
|
Pferdestarke
|
| Units
|
Meaning
|
| "T"
|
Tesla
|
| "ga"
|
Gauss
|
| Units
|
Meaning
|
| "C" (or "Cel")
|
Degree Celsius
|
| "F" (or "fah")
|
Degree Fahrenheit
|
| "K" (or "kel")
|
Kelvin
|
| "Rank"
(2019 SR0)
|
Degress Rankine
|
| "Reau"
(2019 SR0)
|
Degrees Reaumer
|
| Units
|
Meaning
|
| "tsp"
|
Teaspoon
|
| "tbs"
|
Tablespoon
|
| "oz"
|
Fluid Ounce
|
| "cup"
|
Cup
|
| "pt" (or "us_pt")
|
U.S. Pint
|
| "uk_pt"
|
U.K. Pint
|
| "qt"
|
Quart
|
| "gal"
|
Gallon
|
| "l" (or "lt")
|
Liter
|
Minimum Origin Version Required: 2019 SR0
| Units
|
Meaning
|
| "uk_acre"
|
International acre
|
| "us_acre"
|
U.S. survey/statute acre
|
| "ang2" (or “ang^2")
|
Square angstrom
|
| "ar"
|
Are
|
| "ft2" (or "ft^2")
|
Square feet
|
| "ha"
|
Hectare
|
| "in2" (or "in^2")
|
Square inches
|
| "ly2" (or "ly^2")
|
Square light-year
|
| "m2" (or "m^2")
|
Square meters
|
| "Morgen"
|
Morgen
|
| "mi2" (or "mi^2")
|
Square miles
|
| "Nmi2" (or "Nmi^2")
|
Square nautical miles
|
| "Picapt2" ("Pica2", "Pica^2" or "Picapt^2")
|
Square Pica
|
| "yd2" (or "yd^2")
|
Square yards
|
Minimum Origin Version Required: 2019 SR0
| Units
|
Meaning
|
| "bit"
|
Bit
|
| "byte"
|
Byte
|
Minimum Origin Version Required: 2019 SR0
| Units
|
Meaning
|
| "admkn"
|
Admiralty knot
|
| "kn"
|
Knot
|
| "m/h" (or "m/hr")
|
Meters per hour
|
| "m/s" (or "m/sec")
|
Meters per second
|
| "mph"
|
Miles per hour
|
- Abbreviated Unit Prefixes
The following abbreviated unit prefixes can be used for any metric unit.
| Prefix
|
Multiplier
|
Abbreviation
|
| exa
|
1e+18
|
"E"
|
| peta
|
1e+15
|
"P"
|
| tera
|
1e+12
|
"T"
|
| giga
|
1e+9
|
"G"
|
| mega
|
1e+6
|
"M"
|
| kilo
|
1e+3
|
"k"
|
| hecto
|
1e+2
|
"h"
|
| dekao
|
1e+1
|
"e"
|
| deci
|
1e-1
|
"d"
|
| centi
|
1e-2
|
"c"
|
| milli
|
1e-3
|
"m"
|
| micro
|
1e-6
|
"u"
|
| nano
|
1e-9
|
"n"
|
| pico
|
1e-12
|
"p"
|
| femto
|
1e-15
|
"f"
|
| atto
|
1e-18
|
"a"
|
| yotta
(2019 SR0)
|
1E+24
|
"Y"
|
| zetta
(2019 SR0)
|
1E+21
|
"Z"
|
| yocto
(2019 SR0)
|
1E-24
|
"y"
|
| zepto
(2019 SR0)
|
1E-21
|
"z"
|
Minimum Origin Version Required: 2019 SR0
| Prefix
|
Value
|
Abbreviation
|
| yobi
|
2^80 = 1208925819614629174706176
|
"Yi"
|
| zebi
|
2^70 = 1180591620717411303424
|
"Zi"
|
| exbi
|
2^60 = 1152921504606846976
|
"Ei"
|
| pebi
|
2^50 = 1125899906842624
|
"Pi"
|
| tebi
|
2^40 = 1099511627776
|
"Ti"
|
| gibi
|
2^30 = 1073741824
|
"Gi"
|
| mebi
|
2^20 = 1048576
|
"Mi"
|
| kibi
|
2^10 = 1024
|
"ki"
|
Return
Return the result number after units conversion, or -1 for error.
Example
convert(2011, "yr", "day") = ; // 734517.75
convert(1, "W", "C") = ; // -1, error
convert(10, "kJ", "EeV") = ; // 62415.097523028
double nKTemp = 273.0;
string strK$ = K;
string strF$ = F;
double dFTemp = convert(nKTemp, strK$, strF$);
dFTemp = ; // 31.73
|