Compartilhar 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 quilómetros 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 Variant O valor em de_unidades a ser convertido.
Arg2 Obrigatório Variant A unidade do número.
Arg3 Obrigatório Variant A unidade do resultado. Converter aceita os seguintes valores de texto (entre aspas) para from_unit e to_unit, que estão listados na secção Observações.

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"
Polegada "in"
"ft"
Quintal "yd"
Angstrom "ang"
Paica (1/72 pol.) "Pica"
Time De_unidade ou para_unidade
Ano "yr"
Day "dia"
Hora "hr"
Minuto "mn"
Segundo "seg"
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 de potência "HPh" (ou "hh")
Hora de watt "Wh" (ou "wh")
Rodapé "flb"
BTU "BTU" (ou "btu")
Power De_unidade ou para_unidade
Potência de 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 de chá "colher de chá"
Colher de sopa "tbs"
Onça fluida "oz"
Copo "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.

Prefixo Multiplicador Abbreviation
exa 1E+18 "E"
pétala 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"
mili 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 gera um erro.

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

Se a unidade não suportar um prefixo de unidade abreviado, Converter gera um erro.

Se as unidades estiverem em grupos diferentes, Converter gera 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.