WorksheetFunction.Convert(Object, Object, Object) メソッド

定義

数値の単位を変換します。 たとえば、 Convert を使用すると、距離テーブルをマイル単位でキロメートル単位の距離テーブルに変換できます。

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

パラメーター

Arg1
Object

変換する値を指定します。

Arg2
Object

数値の単位を指定します。

Arg3
Object

変換後の単位を指定します。 Convert では、以下の「解説」セクションに記載されているfrom_unitとto_unitに対して、次のテキスト値 (引用符で囲む) を受け入れます。

戻り値

注釈

グラム"g"
スラグ"sg"
ポンド (常衡)"lbm"
U (原子質量単位)"u"
オンス (常衡)"ozm"
メートル"m"
法定マイル"mi"
海里"Nmi"
インチ"in"
フィート"ft"
ヤード"yd"
オングストローム"ang"
パイカ (1/72 インチ)"Pica"
Year"yr"
"day"
"hr"
"mn"
"sec"
パスカル"Pa" (または "p")
気圧"atm" (または "at")
ミリメートル Hg"mmHg"
ニュートン"N"
ダイン"dyn" (または "dy")
ポンド フォース"lbf"
ジュール"J"
エルグ"e"
カロリー (物理化学的熱量)"c"
カロリー (生理学的代謝熱量)"cal"
電子ボルト"eV" (または "ev")
馬力時"HPh" (または "hh")
ワット時"Wh" (または "wh")
フィートポンド"flb"
BTU (英国熱量単位)"BTU" (または "btu")
馬力"HP" (または "h")
ワット"W" (または "w")
テスラ"T"
ガウス"ga"
摂氏"C" (または "cel")
華氏"F" (または "fah")
絶対温度"K" (または "kel")
ティースプーン"tsp"
テーブルスプーン"tbs"
オンス"oz"
カップ"cup"
パイント (米)"pt" (または "us_pt")
パイント (英)"uk_pt"
クォート"qt"
ガロン"gal"
リットル"l" (または "lt")

次に示す 10 のべき乗に対応する略語は、変換前単位または変換後単位に前置することができます。

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"

入力データ型が正しくない場合は、 Convert によってエラーが生成されます。

ユニットが存在しない場合、 Convert によってエラーが生成されます。

ユニットが短縮単位プレフィックスをサポートしていない場合は、 Convert によってエラーが生成されます。

単位が異なるグループ内にある場合は、 変換 によってエラーが生成されます。

単位名と略語の大文字と小文字は区別されます。

適用対象