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メートル)