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

Definição

Converte um número de um sistema de medida para outro. Por exemplo, Convert pode converter uma tabela de distâncias em milhas em 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 listados na seção Comentários abaixo.

Retornos

Comentários

Grama"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"em"
"ft"
Pátio"yd"
Angstrom"ang"
Paica (1/72 pol.)"Pica"
Ano"ano"
Day"dia"
Hora"hr"
Minuto"mn"
Segundo"sec"
Pascal"Pa"
Atmosfera"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")
Cavalos de potência-hora"HPh" (ou "hh")
Watt-hora"Wh" (ou "wh")
Pé-libra"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")
colher de chá"tsp"
colher de sopa"TBS"
Onça fluida"oz"
Copa"copo"
Pinta americana"pt" (ou "us_pt")
Pinta inglesa"uk_pt"
Quarto"qt"
Galão"gal"
litro"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"
quilo1E+03"k"
hecto1E+02"h"
dekao1E+01"e"
deci1E-01"d"
centi1E-02"c"
mili1E-03"m"
micro1E-06"u"
nano1E-09"N"
pico1E-12"p"
femto1E-15"f"
atto1E-18"uma"

Se os tipos de dados de entrada estiverem incorretos, Converter gerará um erro.

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

Se a unidade não for compatível com um prefixo de unidade abreviado, Convert gerará um erro.

Se as unidades estiverem em grupos diferentes, Convert gerará um erro.

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

Aplica-se a