3.5.11.5 Convert

Contents

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

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