Partilhar via


Método WorksheetFunction.Convert (Excel)

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.

Sintaxe

expressão. Converter (Arg1, Arg2, Arg3)

Expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Arg1 Obrigatório Variantes O valor em de_unidades a ser convertido.
Arg2 Obrigatório Variantes A unidade do número.
Arg3 Obrigatório Variantes 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.

Valor de retorno

Double

Comentários

Peso e massa De_unidade ou para_unidade
Grama "g"
Lesma "sg"
Massa em libras (avoirdupois) "lbm"
U (unidade de massa atômica) "u"
Massa em onças (avoirdupois) "ozm"
Distância De_unidade ou para_unidade
Medidor "m"
Milha inglesa "mi"
Milha náutica "Nmi"
Polegadas "in"
"ft"
Jarda "yd"
Angstrom "ang"
Paica (1/72 pol.) "Pica"
Time De_unidade ou para_unidade
Ano "yr"
Dia "day"
Hora "hr"
Minuto "mn"
Segundo "s"
Pressão De_unidade ou para_unidade
Pascal "Pa"
Atmosfera "atm"
mm de Mercúrio "mmHg"
Force De_unidade ou para_unidade
Newton "N"
Dyne "dina"
Libra-força "lbf"
Energia De_unidade ou para_unidade
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")
Potência De_unidade ou para_unidade
Cavalos "HP" (ou "h")
Watt "W" (ou "w")
Magnetismo De_unidade ou para_unidade
Tesla "T"
Gauss "ga"
Temperatura De_unidade ou para_unidade
Grau Celsius "C" (ou "cel")
Grau Fahrenheit "F" (ou "fah")
Kelvin "K" (ou "kel")
Medida líquida De_unidade ou para_unidade
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.

Prefixo Multiplicador Abbreviation
exa 1E+18 "E"
Peta 1E+15 "P"
Tera 1E+12 "T"
giga 1E+09 "G"
Mega 1E+06 "M"
Quilo 1E+03 "k"
hecto 1E+02 "h"
dekao 1E+01 "e"
Deci 1E-01 "d"
centi 1E-02 "c"
Milli 1E-03 "m"
Micro 1E-06 "u"
Nano 1E-09 "n"
pico 1E-12 "p"
Femto 1E-15 "f"
Atto 1E-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.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.