CONVERT function

Converts a value from one unit of measurement to the corresponding value in another unit of measurement. Enter the units of measurement directly as text in quotation marks or as a reference. The units of measurement specified through the arguments must match the supported unit symbols, which are case-sensitive. For example, the symbol for the unit "newton" is the uppercase "N".

The measurement units recognized by CONVERT fall into 13 groups, which are listed below. CONVERT will perform conversions between any two units within one group but reject any request to convert between units in different groups.

You can also add binary and decimal prefixes to units of measurement that support them. The list of all prefixes and their corresponding multipliers are shown below.

This function may not be compatible with other spreadsheet software.

Sintaxe

CONVERT(Number; FromUnit; ToUnit)

número é o número a converter.

da_unidade é a unidade de medida do número a converter.

para_unidade é a unidade de medida do resultado. As duas unidades têm de ser do mesmo tipo.

If FromUnit and ToUnit are not valid units from the same group, then CONVERT reports an invalid argument error (Err:502).

Exemplos

=CONVERT(-10; "C"; "F")

Here the function converts -10 degrees Celsius to degrees Fahrenheit, returning the value 14. There is not a simple multiplicative relationship between temperature units, as different reference points are used. Hence, as in this case, an input negative number may be converted to a positive value.

=CONVERT(3.5; "mi"; "yd")

Here the function converts 3.5 international miles to yards, returning the value 6160. Both units are in the Length and distance group.

=CONVERT(256; "Gibit"; "Mibyte")

Here the function converts 256 gigibits to mebibytes, returning the value 32768. Both units (bit and byte) are in the Information group and support binary prefixes.

=CONVERT(1; "dyn"; "e")

Here the function returns an invalid argument error (Err:502) because the two units (dyne and erg) are in different groups (Force and Energy respectively).

Units of measurement

Below are the unit measurement groups supported by the CONVERT function. Be aware that conversions can only happen between units that belong to the same group.

The column Prefix indicates whether or not a given unit of measurement supports prefixes.

Área

Some measurement units have more than one accepted symbol. The accepted unit symbols are separated by semicolons in the Unit symbol column.

Unit symbol	Descrição	Prefixo
"ang2" ; "ang^2"	Square angstrom	Sim
"ar"	Are	Sim
"ft2" ; "ft^2"	Square foot	não
"ha"	Hectare	não
"in2" ; "in^2"	Square inch	não
"ly2" ; "ly^2"	Square light-year	não
"m2" ; "m^2"	Square meter	Sim
"mi2" ; "mi^2"	Square international mile	não
"Morgen"	Morgen	não
"Nmi2" ; "Nmi^2"	Square nautical mile	não
"Pica2" ; "Pica^2" ; "picapt2" ; "picapt^2"	Square pica point	não
"pica2" ; "pica^2"	Square pica	não
"uk_acre" ; "acre"	International acre	não
"us_acre"	US survey acre	não
"yd2" ; "yd^2"	Square yard	não

Energia

Unit symbol	Descrição	Prefixo
"BTU" ; "btu"	British thermal unit	não
"c"	Thermochemical calorie	Sim
"cal"	International Steam Table calorie	Sim
"e"	erg	Sim
"eV" ; "ev"	Electron volt	Sim
"flb"	Foot-pound	não
"HPh" ; "hh"	Horsepower-hour	não
"J"	Joule	Sim
"Wh" ; "wh"	Watt-hour	Sim

Flux density

Unit symbol	Descrição	Prefixo
"ga"	Gauss	Sim
"T"	Tesla	Sim

Força

Unit symbol	Descrição	Prefixo
"dyn" ; "dy"	Dyne	Sim
"N"	Newton	Sim
"lbf"	Pound-force	não
"pond"	Pond	Sim

Informações

Unit symbol	Descrição	Prefixo
"bit"	Bit	Sim
"byte"	Byte	Sim

Length and distance

Unit symbol	Descrição	Prefixo
"ang"	Angstrom	Sim
"ell"	Ell	não
"ft"	Pés	não
"in"	Polegada	não
"ly" ; "lightyear"	Light-year	Sim
"m"	Metro	Sim
"mi"	International mile	não
"Nmi"	Nautical mile	não
"parsec" ; "pc"	Parsec	Sim
"Pica" ; "picapt"	Pica point	não
"pica"	Pica	não
"survey_mi"	US survey mile	não
"yd"	Yard	não

Mass and weight

Unit symbol	Descrição	Prefixo
"cwt" ; "shweight"	Short hundredweight	não
"g"	Gram	Sim
"grain"	Grain	não
"lbm"	Pound	não
"ozm"	Ounce	não
"pweight"	Pennyweight	não
"sg"	Slug	não
"stone"	Pedra	não
"ton"	Short ton	não
"u"	Unified atomic mass unit	Sim
"uk_cwt" ; "lcwt" ; "hweight"	Long hundredweight	não
"uk_ton" ; "LTON" ; "brton"	Long ton	não

Potência

Unit symbol	Descrição	Prefixo
"HP" ; "h"	Mechanical horsepower	não
"PS"	Pferdestärke or metric horsepower	não
"W" ; "w"	Watt	Sim

Pressão

Unit symbol	Descrição	Prefixo
"atm" ; ("at")⁽¹⁾	Standard atmosphere	Sim
"mmHg"	Millimeter of mercury	Sim
"Pa"	Pascal	Sim
"psi"	Pound per square inch	não
"Torr"	Torr	não

1 - The "at" unit is deprecated. Use "atm" instead.

Velocidade

Unit symbol	Descrição	Prefixo
"admkn"	Admiralty knot	não
"kn"	International knot	não
"m/h" ; "m/hr"	Meters per hour	Sim
"m/s" ; "m/sec"	Meters per second	Sim
"mph"	Miles per hour	não

Temperatura

Unit symbol	Descrição	Prefixo
"C" ; "cel"	Degree Celsius	não
"F" ; "fah"	Degree Fahrenheit	não
"K" ; "kel"	Kelvin	Sim
"Rank"	Degree Rankine	não
"Reau"	Degree Réaumur	não

Hora

Unit symbol	Descrição	Prefixo
"day" ; "d"	Dia	não
"hr"	Hora	não
"mn" ; "min"	Minuto	não
"sec" ; "s"	Segundo	Sim
"yr"	Ano	não

Volume

Unit symbol	Descrição	Prefixo
"ang3" ; "ang^3"	Cubic angstrom	Sim
"barrel"	Oil barrel	não
"bushel"	US bushel	não
"cup"	US cup	não
"ft3" ; "ft^3"	Cubic foot	não
"gal"	US gallon	não
"Glass"⁽²⁾	Australian glass (200 milliliters)	não
"GRT" ; "regton"	Gross register tonnage	não
"Humpen"⁽²⁾	Humpen (500 milliliters)	não
"in3" ; "in^3"	Cubic inch	não
"l" ; "L" ; "lt"	Liter	Sim
"ly3" ; "ly^3"	Cubic light-year	não
"m3" ; "m^3"	Cubic meter	Sim
"mi3" ; "mi^3"	Cubic international mile	não
"Middy"⁽²⁾	Australian middy (285 milliliters)	não
"MTON"	Measurement ton	não
"Nmi3" ; "Nmi^3"	Cubic nautical mile	não
"oz"	US fluid ounce	não
"Pica3" ; "Pica^3" ; "picapt3" ; "picapt^3"	Cubic pica point	não
"pica3" ; "pica^3"	Cubic pica	não
"pt" ; "us_pt"	US pint	não
"qt"	US quart	não
"Schooner"⁽²⁾	Australian schooner (425 milliliters)	não
"Sixpack"⁽²⁾	Six pack (2 liters)	não
"tbs"	US tablespoon	não
"tsp"	US teaspoon	não
"tspm"	Metric teaspoon	não
"uk_gal"	Imperial gallon	não
"uk_pt"	Imperial pint	não
"uk_qt"	Imperial quart	não
"yd3" ; "yd^3"	Cubic yard	não

2 - These units are not part of the Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format standard for the CONVERT function. They are preserved for backward compatibility.

Prefixes

Decimal prefixes

Prefixo	Multiplicador
Y (yotta)	10²⁴
Z (zetta)	10²¹
E (exa)	10¹⁸
P (peta)	10¹⁵
T (tera)	10¹²
G (giga)	10⁹
M (mega)	10⁶
k (kilo)	10³
h (hecto)	10²
e (deca)	10¹
d (deci)	10^-1
c (centi)	10^-2
m (milli)	10^-3
u (micro)	10^-6
n (nano)	10^-9
p (pico)	10^-12
f (femto)	10^-15
a (atto)	10^-18
z (zepto)	10^-21
y (yocto)	10^-24

Binary prefixes

Prefixo	Multiplicador
Yi (yobi)	2⁸⁰
Zi (zebi)	2⁷⁰
Ei (exbi)	2⁶⁰
Pi (pebi)	2⁵⁰
Ti (tebi)	2⁴⁰
Gi (gibi)	2³⁰
Mi (mebi)	2²⁰
ki (kibi)	2¹⁰

Technical information

This function is not part of the Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format standard. The name space is

ORG.OPENOFFICE.CONVERT

CONVERT Wiki page