Help:単位の変換
この文書は手引き書です。ウィキペディア日本語版での活動の参考にされていますが、方針やガイドラインではありません。 |
{{Convert}}は単位付きの数字を、別の単位に変換して併記するためのテンプレートです。このページでは主にテンプレート引数について説明します。
- Help:単位の変換/単位一覧 - よく使われる単位の一覧
- Help:単位の変換/テンプレートエラー - エラーメッセージや警告メッセージについて
質問がある場合
[編集]- Template‐ノート:Convert - Convertテンプレートの使い方に関する質問、新しい単位の追加提案などはこちら
- Wikipedia:利用案内 - 一般的な質問はこちら
使用できる単位
[編集]- Help:単位の変換/単位一覧 - よく使われる単位の一覧
- モジュール:Convert/documentation/変換データ - 使用できる全ての単位の一覧
基本的な使い方
[編集]一般的には第1引数に数字を、第2引数に変換元の単位を、第3引数に変換先の単位を指定します。第4引数は変換先の精度を指定します。表示では変換元の単位が名称で表示され、変換先の単位が略号で表示されますが、|abbr=
引数でこの挙動を変更できます。また、名称で表示する単位は既定では日本語で表示しますが、|sp=us
と指定することで英語で表示します。
{{convert|123.4|ft|m}}
→ 123.4フィート (37.6 m){{convert|123.4|ft|m|abbr=on}}
→ 123.4 ft (37.6 m){{convert|123.4|ft|m|abbr=off}}
→ 123.4フィート (37.6メートル){{convert|123.4|ft|m|abbr=off|sp=us}}
→ 123.4 feet (37.6 meters){{convert|123.4|ft|m|0}}
→ 123.4フィート (38 m){{convert|123.4|ft|m|3}}
→ 123.4フィート (37.612 m)
上記はフィートからメートルに変換する例ですが、メートルからフィートやインチに変換することもできます。また、入力する数字に分数も指定できます。
{{convert|12.34|m|ft}}
→ 12.34メートル (40.5 ft){{convert|12.34|m|ftin}}
→ 12.34メートル (40 ft 6 in){{convert|12.34|m|ftin|frac=4}}
→ 12.34メートル (40 ft 5+3⁄4 in){{convert|40|ft|6|in|m}}
→ 40フィート6インチ (12.34 m){{convert|5+3/4|in|mm}}
→ 5+3⁄4インチ (150 mm){{convert|5+3/4|in|mm|0}}
→ 5+3⁄4インチ (146 mm)
単位へのリンクはリンク過多にならないよう、一般的には作成されませんが、|lk=
引数で作成するように指定できます。|lk=out
で変換先の単位が、|lk=in
で変換元の単位が、|lk=on
で両方がリンクされます。
{{convert|12300|m2|rood|abbr=off|lk=out}}
→ 12,300平方メートル (12.2ルード){{convert|12.2|rood|m2|abbr=off|lk=in}}
→ 12.2ルード (12,300平方メートル){{convert|12300|m2|rood|abbr=off|lk=on}}
→ 12,300平方メートル (12.2ルード)
変換先の単位を指定しなかった場合は既定の単位に変換されます。
{{convert|123.4|ft}}
→ 123.4フィート (37.6 m){{convert|123.4|ft|abbr=on}}
→ 123.4 ft (37.6 m)
既定では変換元、変換先の順で表示されますが、|order=flip
と指定することで変換先を先に表示することができます。
{{convert|12300|m2|rood|abbr=off|order=flip}}
→ 12.2ルード (12,300平方メートル)
|order=flip
と指定した場合は|lk=
引数の意味も逆になります。
値は単一の値だけでなく、範囲の形で指定することもできます。
{{convert|3|-|6|ft}}
→ 3–6フィート (0.91–1.83 m){{convert|3|to|6|ft|abbr=off|sp=us}}
→ 3 - 6 feet (0.91 - 1.83 meters)
範囲が複数の値で構成されることもあります。たとえば、物体のサイズは3つの数字(幅×奥行き×高さ)で構成されます。
{{convert|100|x|120|x|210|mm|in}}
→ 100 by 120 by 210ミリメートル (3.9 in × 4.7 in × 8.3 in){{convert|100|x|120|x|210|mm|in|abbr=on}}
→ 100 mm × 120 mm × 210 mm (3.9 in × 4.7 in × 8.3 in){{convert|100|by|120|by|210|mm|in}}
→ 100 by 120 by 210ミリメートル (3.9 by 4.7 by 8.3 in)
単位の中には複数の部分で構成されるものもあります。例えば、フィートとインチは一緒に使われることが多いです。
{{convert|5|ft|8|in}}
→ 5フィート8インチ (1.73 m){{convert|11|st|3|lb|kg}}
→ 11ストーン3ポンド (71 kg)
変換先の単位はスペース区切りで複数指定できます。
{{convert|123|nmi|km mi}}
→ 123海里 (228 km; 142 mi){{convert|123|hPa|psi inHg|abbr=on|lk=on}}
→ 123 hPa (1.78 psi; 3.6 inHg)
ydftin
のように変換先の単位を指定することで、変換結果が複数の単位の組み合わせになります。
{{convert|123.4|m|ydftin}}
→ 123.4メートル (134 yd 2 ft 10 in){{convert|123.4|kg|stlb}}
→ 123.4キログラム (19 st 6 lb)
- 単位の組み合わせは決まっており、特定の単位しか使用できません。スペースつきで入力した場合は別々に変換され、それぞれフルネームで入力した場合はエラーになります。
{{convert|123.4|m|yd ft in}}
→ 123.4メートル (135.0 yd; 405 ft; 4,860 in){{convert|123.4|m|yardfootinch}}
→ 123.4 m Template:Convertのエラー: 不明な単位「yardfootinch」が指定されました
端数処理
[編集]既定では変換先が変換元と同じ精度になるよう丸められます。たとえば、「1234」の精度は「1234 ± 0.5」として、「1200」の精度は「1200 ± 50」として扱われます。
既定以外の挙動は下記の引数で指定できます。
- 変換先単位の後の引数に
|N
(N
は正の整数)と指定することで、小数点以下N桁に丸めます。 - 変換先単位の後の引数に
|-N
(-N
は負の整数)と指定することで、小数点以上N桁までを0に置換します(すなわち、 最も近い10Nの倍数に丸めます)。 |sigfig=N
(N
は正の整数)と指定することで、有効数字の桁数を指定できます。|round=5
と指定することで、最も近い5の倍数に丸めます(スウェディッシュ・ラウンディング)。5以外では0.5、10、25、50も指定できます。
例:
{{convert|1234|ft|m}}
→ 1,234フィート (376 m){{convert|1234|ft|m|2}}
→ 1,234フィート (376.12 m){{convert|1234|ft|m|-1}}
→ 1,234フィート (380 m){{convert|1234|ft|m|round=5}}
→ 1,234フィート (375 m){{convert|1234|ft|m|round=10}}
→ 1,234フィート (380 m){{convert|1234|ft|m|round=25}}
→ 1,234フィート (375 m){{convert|1234|ft|m|round=50}}
→ 1,234フィート (400 m){{convert|1234|ft|m|sigfig=2}}
→ 1,234フィート (380 m){{convert|1234|ft|m|sigfig=4}}
→ 1,234フィート (376.1 m){{convert|1230|ft|m}}
→ 1,230フィート (370 m){{convert|1230|ft|m|0}}
→ 1,230フィート (375 m){{convert|1230|ft|m|1}}
→ 1,230フィート (374.9 m){{convert|5670|sqft}}
→ 5,670平方フィート (527 m2){{convert|5670|sqft|-2}}
→ 5,670平方フィート (500 m2){{convert|7|x|8|x|12|ft|abbr=on|round=0.5}}
→ 7 ft × 8 ft × 12 ft (2 m × 2.5 m × 3.5 m)
「5000」は有効数字1桁、「5001」は有効数字4桁として扱われます。「5000」を有効数字4桁として扱う場合は「5000.」と指定します。
{{convert|5000|m}}
→ 5,000メートル (16,000 ft){{convert|5000.|m}}
→ 5,000メートル (16,404 ft)
英語表記
[編集]|sp=us
と指定することで、日本語名が設定された単位でも英語名を表示します。
{{convert|6|km}}
→ 6キロメートル (3.7 mi){{convert|6|km|sp=us}}
→ 6 kilometers (3.7 mi)
|spell=in
と指定することで、数字も英語で表示され、|spell=In
("I
"が大文字)と指定することで先頭が大文字になります。この引数は必ず|sp=us
と併用します。
{{convert|5|mi|km|spell=in|sp=us}}
→ five miles (8.0 km){{convert|5|mi|km|spell=in|abbr=off|0|sp=us}}
→ five miles (8 kilometers){{convert|5|mi|km|spell=In|0|sp=us}}
→ Five miles (8 km){{convert|5|mi|km|spell=In|abbr=off|0|sp=us}}
→ Five miles (8 kilometers){{convert|2+1/4|mi|km|abbr=off|0|spell=In|sp=us}}
→ Two and a fourth miles (4 kilometers)
|order=flip
と併用した場合は変換先の数字が英語で表示されます。
{{convert|5|mi|0|order=flip|spell=in|sp=us}}
→ eight kilometers (5 mi){{convert|5|mi|0|order=flip|spell=In|abbr=off|sp=us}}
→ Eight kilometers (5 miles)
変換元と変換先を両方とも英語で表示する場合は|spell=on
または|spell=On
と指定します。
{{convert|5|mi|m|-2|spell=on|sp=us|abbr=off}}
→ five miles (eight thousand meters){{convert|5|mi|m|-2|spell=On|sp=us|abbr=off}}
→ Five miles (eight thousand meters)
数字の桁の区切り
[編集]数字の桁の区切りにはコンマを使います(例:1,000
)。スペースは使用できません(例:1 000
)。
出力では変換元・変換先ともに既定で桁の区切りにコンマを使います。
{{convert|1234567|m|ft}}
→ 1,234,567メートル (4,050,417 ft){{convert|1,234,567|m|ft}}
→ 1,234,567メートル (4,050,417 ft)
|comma=off
と指定することで、区切りのコンマを出力しません。
{{convert|1,234,567|m|ft|comma=off}}
→ 1234567メートル (4050417 ft)
|comma=5
と指定することで、区切りのコンマは数字が5桁以上のときだけ使用します。
{{convert|1234|m|ft}}
→ 1,234メートル (4,049 ft){{convert|1234|m|ft|comma=5}}
→ 1234メートル (4049 ft){{convert|12345|m|ft|comma=5}}
→ 12,345メートル (40,502 ft)
|comma=gaps
と指定することで、区切りにスペースを使用します。テンプレートの表示をコピーした場合はスペースがコピーされません。
{{convert|1234567|m|ft}}
→ 1,234,567メートル (4,050,417 ft){{convert|1234567|m|ft|comma=gaps}}
→ 1234567メートル (4050417 ft)
|comma=gaps
と指定したときは小数点以下の桁もスペース区切りになりますが、スペースの後が1桁しかない場合はスペースを出力しません。スペースの後が1桁しかない場合でもスペースを出力する場合は|comma=gaps3
と指定します。
{{convert|1234.98765|m|ft|comma=gaps}}
→ 1234.98765メートル (4051.7968 ft){{convert|1234.98765|m|ft|comma=gaps3}}
→ 1234.98765メートル (4051.7968 ft){{convert|1234.9876|m|ft|comma=gaps}}
→ 1234.9876メートル (4051.797 ft){{convert|1234.9876|m|ft|comma=gaps3}}
→ 1234.9876メートル (4051.797 ft){{convert|1.2349876|m|ft|comma=gaps}}
→ 1.2349876メートル (4.051797 ft){{convert|1.2349876|m|ft|comma=gaps3}}
→ 1.2349876メートル (4.051797 ft)
分数
[編集]変換元の値は分数を指定できます。
{{convert|1/2|in|mm|1}}
→ 1⁄2インチ (12.7 mm){{convert|1/2|in|mm|1|adj=on}}
→ 1⁄2-インチ (12.7 mm){{convert|2+1/2|in|mm|1}}
→ 2+1⁄2インチ (63.5 mm){{convert|1|ft|10+5/8|in}}
→ 1フート10+5⁄8インチ (0.575 m){{convert|-2-1/4|in|mm|1}}
→ −2+1⁄4インチ (−57.2 mm){{convert|1/2|in|mm|1|spell=in|sp=us}}
→ one-half inch (12.7 mm)
分数の指定にスラッシュ2つ(//
)を使用した場合、括線は斜めの線ではなく横の線を使います。
{{convert|1//2|in|mm|1}}
→ 1/2インチ (12.7 mm){{convert|2+1//2|in|mm|1}}
→ 2+1/2インチ (63.5 mm)
|frac=N
(Nは分母)と指定することで、変換先の値を分数で表示できます。例えば、|frac=8
は変換先の値を最も近い8分の1の倍数に丸めます。表示では既約分数で表示します。
{{convert|219|mm|in|abbr=on}}
→ 219 mm (8.6 in){{convert|219|mm|in|abbr=on|frac=2}}
→ 219 mm (8+1⁄2 in){{convert|219|mm|in|abbr=on|frac=4}}
→ 219 mm (8+1⁄2 in){{convert|219|mm|in|abbr=on|frac=8}}
→ 219 mm (8+5⁄8 in){{convert|222|mm|in|abbr=on|frac=8}}
→ 222 mm (8+3⁄4 in)
frac
引数の指定は変換先の単位が1つの場合、その単位に適用されます。変換先の単位が複数の場合は非SI単位に適用され、frac
引数と小数点以下の桁数が両方とも指定された(|frac=2|1
のような指定)場合、ハンドにのみ適用されます。
{{convert|18.45|in|m|frac=2}}
→ 18.45インチ (1⁄2 m){{convert|18.45|in|ft in hand cm|frac=2}}
→ 18.45インチ (1+1⁄2 ft; 18+1⁄2 in; 4.2+1⁄2ハンド; 46.9 cm){{convert|18.45|in|ft in hand cm|frac=2|1}}
→ 18.45インチ (1.5 ft; 18.5 in; 4.2+1⁄2ハンド; 46.9 cm)
|frac=-N
と指定した場合(Nは分母)、括線は斜めの線ではなく横の線を使います。
{{convert|12.7|mm|frac=-2}}
→ 12.7ミリメートル (1/2 in){{convert|222|mm|in|abbr=on|frac=-8}}
→ 222 mm (8+3/4 in)
変換元と変換先の区切り
[編集]|disp=
引数(display、「表示」の意味)は変換元と変換先の区切り記号を指定できます。
テンプレート | 表示 | 区切り記号 |
---|---|---|
{{convert|2.4|m|ft}} |
2.4メートル (7.9 ft) | 半角丸括弧(既定) |
{{convert|2.4|m|ft|disp=sqbr}} |
2.4メートル [7.9 ft] | 半角角括弧 |
{{convert|2.4|m|ft|disp=or}} |
2.4メートル または 7.9フィート | 「または」 |
{{convert|2.4|m|ft|disp=comma}} |
2.4メートル, 7.9 ft | コンマ |
{{convert|2.4|m|ft|disp=br}} |
2.4メートル 7.9フィート |
<br />要素(改行) |
{{convert|2.4|m|ft|disp=br()}} |
2.4メートル (7.9フィート) |
改行と半角丸括弧 |
値の範囲
[編集]変換元の値には範囲を指定できます。区切り文字が英語の場合、|sp=us
を併用します。
区切り文字 | テンプレート | 表示 | 節名 |
---|---|---|---|
-
|
{{convert|3|-|6|ft}}
|
3–6フィート (0.91–1.83 m) | ハイフン(- )とenダッシュ(– )を入力でき、出力ではenダッシュで表示
|
and
|
{{convert|3|and|6|ft|sp=us}}
|
3 and 6 feet (0.91 and 1.83 m) | |
and(-)
|
{{convert|3|and(-)|6|ft|sp=us}}
|
3 and 6 feet (0.91–1.83 m) | 左側に表示する値はand区切り、右側に表示する値はenダッシュ区切り |
and(-)|order=flip
|
{{convert|3|and(-)|6|ft|order=flip|sp=us}}
|
0.91 and 1.83 meters (3–6 ft) | |
or
|
{{convert|3|or|6|ft|sp=us}}
|
3 or 6 feet (0.91 or 1.83 m) | |
to
|
{{convert|3|to|6|ft|sp=us}}
|
3 - 6 feet (0.91 - 1.83 m) | |
to(-)
|
{{convert|3|to(-)|6|ft|sp=us}}
|
3 to 6 feet (0.91–1.83 m) | 左側に表示する値はto区切り、右側に表示する値はenダッシュ区切り |
to(-)|order=flip
|
{{convert|3|to(-)|6|ft|order=flip|sp=us}}
|
0.91 to 1.83 meters (3–6 ft) | |
to about
|
{{convert|3|to about|6|ft|sp=us}}
|
3 to about 6 feet (0.91 to about 1.83 m) | |
+/-
|
{{convert|3|+/-|6|ft}}
|
3 ± 6フィート (0.91 ± 1.83 m) | |
± ±
|
{{convert|3|±|6|ft}}
|
3 ± 6フィート (0.91 ± 1.83 m) | |
+
|
{{convert|3|+|6|ft}}
|
3 + 6フィート (0.91 + 1.83 m) | |
,
|
{{convert|3|,|6|ft}}
|
3, 6フィート (0.91, 1.83 m) | |
, and
|
{{convert|3|, and|6|ft|sp=us}}
|
3, and 6 feet (0.91, and 1.83 m) | |
, or
|
{{convert|3|, or|6|ft|sp=us}}
|
3, or 6 feet (0.91, or 1.83 m) | |
/
|
{{convert|83|/|63|F|disp=br()|abbr=values}}
|
83 / 63 (28 / 17) |
最高/最低温度で使用する表記 |
by
|
{{convert|3|by|6|ft|sp=us}}
|
3 by 6 feet (0.91 by 1.83 m) | |
by(x)
|
{{convert|3|by(x)|6|ft|sp=us}}
|
3 by 6 feet (0.91 m × 1.83 m) | 左側に表示する値はby区切り、右側に表示する値は×区切り |
by(x)|order=flip
|
{{convert|3|by(x)|6|ft|order=flip|sp=us}}
|
0.91 by 1.83 meters (3 ft × 6 ft) | |
x
|
{{convert|3|x|6|ft|sp=us}}
|
3 by 6 feet (0.91 m × 1.83 m) | |
x|abbr=on
|
{{convert|3|x|6|ft|abbr=on}}
|
3 ft × 6 ft (0.91 m × 1.83 m) |
範囲には3つ以上の値を指定することもできます。
テンプレート | 表示 |
---|---|
{{convert|3|x|4|x|24|in|sp=us}} |
3 by 4 by 24 inches (76 mm × 102 mm × 610 mm) |
{{convert|3|x|4|to|6+1/2|x|8+3/4|in|sp=us}} |
3 by 4 - 6+1⁄2 by 8+3⁄4 inches (76 mm × 102 mm - 165 mm × 222 mm) |
範囲を指定する場合、第1引数で一気に指定することもできますが、{{convert|3.2|-|7.5|ha}}
のように分けることが推奨されます。
テンプレート | 表示 |
---|---|
{{convert|3.2-7.5|ha}} |
3.2–7.5ヘクタール (7.9–18.5エーカー) |
{{convert|3x4x24|in|sp=us}} |
3 by 4 by 24 inches (76 mm × 102 mm × 610 mm) |
結果を一部だけ表示する
[編集]下記は変換結果を一部だけ表示させる|disp=
引数の使い方を説明します。
テンプレート | 表示 | 出力部分 |
---|---|---|
{{convert|2|cuyd|m3}} |
2立方ヤード (1.5 m3) | 一般的な変換 |
{{convert|2|cuyd|m3|abbr=values}} |
2 (1.5) | 変換元と変換先の値 |
{{convert|2|cuyd|m3|disp=unit}} |
立方ヤード | 変換元の単位名 |
{{convert|2|cuyd|cuyd|disp=out}} |
2.0 cu yd | 変換元(変換先に同じ単位を指定することで表示できる) |
{{convert|2|cuyd|m3|disp=unit2}} |
m3 | 変換先の単位略号 |
{{convert|2|cuyd|m3|disp=unit2|abbr=off}} |
立方メートル | 変換先の単位名 |
{{convert|2|cuyd|m3|disp=number}} |
1.5 | 変換先の値 |
{{convert|2|cuyd|m3|disp=out}} |
1.5 m3 | 変換先の値と単位略号 |
{{convert|2|cuyd|m3|abbr=off|disp=out}} |
1.5立方メートル | 変換先の値と単位名 |
表示順を逆にする
[編集]既定では変換元、変換先の順で表示されますが、|order=flip
と指定することで変換先を先に表示することができます。
{{convert|10|km|mi}}
→ 10キロメートル (6.2 mi){{convert|10|km|mi|order=flip}}
→ 6.2マイル (10 km)
表組み
[編集]下記の引数は表組みでの使用が想定されます。
引数 | 説明 |
---|---|
|disp=table |
align="right" が指定されたセル用
|
|disp=tablecen |
align="center" が指定されたセル用
|
|sortable=on |
先頭に表示されないソートキーを出力する。再整列可能な表用 |
下記は表組み用の引数の使用例です。
テンプレート | 出力ウィキテキスト |
---|---|
{{convert|47.5|kg|lb}} |
47.5 kilograms (105 lb) |
{{convert|47.5|kg|lb|disp=table}} |
align="right"|47.5 |align="right"|105 |
{{convert|47.5|kg|lb|disp=tablecen}} |
align="center"|47.5 |align="center"|105 |
{{convert|47.5|kg|lb|sortable=on}} |
<span style="display:none">7001475000000000000</span>47.5 kilograms (105 lb) |
右揃えの表での使用例
[編集]入力:
{|class="wikitable" ! align=right, rowspan="2" | !colspan="2"| 長さ !colspan="2"| 重さ |- style="vertical-align:bottom;" !metres !!ft in !!kg !!lb |- ! Lorem ipsum | {{convert|28.1|m|ftin|disp=table}} | {{convert|47.5|kg|lb|disp=table}} |- ! Dolor sit amet | {{convert|9.9|m|ftin|disp=table}} | {{convert|74.1|kg|lb|disp=table}} |- ! Consectetur | {{convert|38.2|m|ftin|disp=table}} | {{convert|31.5|kg|lb|disp=table}} |- ! Adipisicing elit | {{convert|18.7|m|ftin|disp=table}} | {{convert|52.7|kg|lb|disp=table}} |}
表示:
長さ | 重さ | |||
---|---|---|---|---|
metres | ft in | kg | lb | |
Lorem ipsum | 28.1 | 92 ft 2 in | 47.5 | 105 |
Dolor sit amet | 9.9 | 32 ft 6 in | 74.1 | 163 |
Consectetur | 38.2 | 125 ft 4 in | 31.5 | 69 |
Adipisicing elit | 18.7 | 61 ft 4 in | 52.7 | 116 |
再整列可能な表での使用例
[編集]入力:
{|class="wikitable sortable" ! align=right, rowspan="2" | !colspan="2"| 長さ !colspan="2"| 重さ |- style="vertical-align:bottom;" !metres !!ft in !!kg !!lb |- ! Lorem ipsum | {{convert|28.1|m|ftin|disp=table|sortable=on}} | {{convert|47.5|kg|lb|disp=table|sortable=on}} |- ! Dolor sit amet | {{convert|9.9|m|ftin|disp=table|sortable=on}} | {{convert|74.1|kg|lb|disp=table|sortable=on}} |- ! Consectetur | {{convert|38.2|m|ftin|disp=table|sortable=on}} | {{convert|31.5|kg|lb|disp=table|sortable=on}} |- ! Adipisicing elit | {{convert|18.7|m|ftin|disp=table|sortable=on}} | {{convert|52.7|kg|lb|disp=table|sortable=on}} |}
表示:
長さ | 重さ | |||
---|---|---|---|---|
metres | ft in | kg | lb | |
Lorem ipsum | 28.1 | 92 ft 2 in | 47.5 | 105 |
Dolor sit amet | 9.9 | 32 ft 6 in | 74.1 | 163 |
Consectetur | 38.2 | 125 ft 4 in | 31.5 | 69 |
Adipisicing elit | 18.7 | 61 ft 4 in | 52.7 | 116 |
単数形と複数形
[編集]単位の略号は常に単数形で表示します。単位名は値が+1の場合のみ単数形で表示し、それ以外は複数形で表示します。日本語では単数形と複数形が同じ単位も多く、異なる例としては「フート」と「フィート」が挙げられます。
{{convert|0.5|ft|m|abbr=off}}
→ 0.5フィート (0.15メートル){{convert|1|ft|m|abbr=off}}
→ 1フート (0.30メートル){{convert|2|ft|m|abbr=off}}
→ 2フィート (0.61メートル)