WorksheetFunction.Convert(Object, Object, Object) Método

Definição

Converte um número de um sistema de medida para outro. Por exemplo, Convert pode traduzir uma tabela de distâncias em milhas para uma tabela de distâncias em quilômetros.

public:
 double Convert(System::Object ^ Arg1, System::Object ^ Arg2, System::Object ^ Arg3);
public double Convert (object Arg1, object Arg2, object Arg3);
Public Function Convert (Arg1 As Object, Arg2 As Object, Arg3 As Object) As Double

Parâmetros

Arg1
Object

O valor em de_unidades a ser convertido.

Arg2
Object

A unidade do número.

Arg3
Object

A unidade do resultado. Convert aceita os seguintes valores de texto (entre aspas) para from_unit e to_unit que estão listados na seção Comentários abaixo.

Retornos

Double

Comentários

Gram"g"
Lesma"sg"
Massa em libras (avoirdupois)"lbm"
U (unidade de massa atômica)"u"
Massa em onças (avoirdupois)"ozm"
Medidor"m"
Milha inglesa"mi"
Milha náutica"Nmi"
Polegada"in"
Foot"ft"
Jarda"yd"
Angström"ang"
Paica (1/72 pol.)"Pica"
Ano"yr"
Dia"day"
Hora"hr"
Minuto"mn"
Segundo"s"
Pascal"Pa"
Ambiente"atm"
mm de Mercúrio"mmHg"
Newton"N"
Dyne"dina"
Libra-força"lbf"
Joule"J"
Erg"e"
Caloria termodinâmica"c"
Caloria IT"cal"
Eletron-volt"eV" (ou "ev")
Hp-hour"HPh" (ou "hh")
Hora de 2007"Wh" (ou "wh")
Foot-pound"flb"
BTU"BTU" (ou "btu")
Cavalos-de-potência"HP" (ou "h")
Watt"W" (ou "w")
Tesla"T"
Gauss"ga"
Grau Celsius"C" (ou "cel")
Grau Fahrenheit"F" (ou "fah")
Kelvin"K" (ou "kel")
Teaspoon"tsp"
Tablespoon"tbs"
Onça fluida"oz"
Cup"cup"
Pinta americana"pt" (ou "us_pt")
Pinta inglesa"uk_pt"
Quart"qt"
Galão"gal"
Liter"l" (ou "lt")

Os seguintes prefixos abreviados de unidades podem ser acrescentados antes de qualquer valor métrico de_unidade ou para_unidade.

exa1E+18"E"
peta1E+15"P"
tera1E+12"T"
giga1E+09"G"
mega1E+06"M"
kilo1E+03"k"
hecto1E+02"h"
dekao1E+01"e"
deci1E-01"d"
centi1E-02"c"
milli1E-03"m"
micro1E-06"u"
nano1E-09"n"
pico1E-12"p"
femto1E-15"f"
atto1E-18"a"

Se os tipos de dados de entrada estão incorretos, Convert gerará um erro.

Se a unidade não existir, Convert gerará um erro.

Se a unidade não suportar um prefixo de unidade abreviado, Convert gerará um erro.

Se as unidades estão em grupos diferentes, Convert gerará um erro.

Nomes de unidades e prefixos fazem distinção entre maiúsculas e minúsculas.

Aplica-se a