Compartilhar via


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

Definição

Converte um número de um sistema de medida para outro. Por exemplo, Converter 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

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"
Polegadas"in"
"ft"
Jarda"yd"
Angstrom"ang"
Paica (1/72 pol.)"Pica"
Ano"yr"
Day"day"
Hora"hr"
Minuto"mn"
Segundo"s"
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")
Hora da potência"HPh" (ou "hh")
Watt-hour"Wh" (ou "wh")
Foot-pound"flb"
BTU"BTU" (ou "btu")
Cavalos"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"tsp"
Colher"tbs"
Onça fluida"oz"
Copo"cup"
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"
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 estiverem incorretos, Converter gerará um erro.

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

Se a unidade não der suporte a um prefixo de unidade abreviado, Converter gerará um erro.

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

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

Aplica-se a