「テンプレート:Convert/doc」を編集中

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude><includeonly>
{{lua|モジュール:Convert}}</includeonly>
==テンプレートの目的==
単位付きの数字を、別の単位に変換して併記するためのテンプレートです。たとえば重さの単位[[グラム]](g)を[[グレーン]](gr)という単位に置き換えるには、<nowiki>{{convert|10|g|gr}}</nowiki>と書けば、{{convert|10|g|gr}}と、2つを並べて書いてくれます。

単位変換の設定（単位の表示名、リンク先など）は[[モジュール:Convert/data]]にあります。

==使用例==
<!--単一の数字の場合:--><!--左の文字、範囲の例を書くまでは省略-->
{| class="wikitable"
!変換!!記法!!表示
|-
|キロメートルからマイルへ||<nowiki>{{convert|18.75|km|mi}}</nowiki>||{{convert|18.75|km|mi}}
|-
|メートルからフィート・インチへ||<nowiki>{{convert|1.85|m|ftin|abbr=on}}</nowiki>||{{convert|1.85|m|ftin|abbr=on}}
|-
|フィート・インチからメートルへ||<nowiki>{{convert|6|ft|3|in|m|2|abbr=on}}</nowiki>||{{convert|6|ft|3|in|2|abbr=on}}
|-
|キログラムからポンドへ||<nowiki>{{convert|3.215|kg|lb}}</nowiki>||{{convert|3.215|kg|lb}}
|-
|°Cから°Fへ||<nowiki>{{convert|100|C|F}}</nowiki>||{{convert|100|C|F}}
|-
|単位を略号にする場合:abbr=ON||<nowiki>{{convert|3.215|kg|lb|abbr=on}}</nowiki>||{{convert|3.215|kg|lb|abbr=on}}
|-
|さらに単位の記事への内部リンクを作成:lk=ON||<nowiki>{{convert|3.215|kg|lb|lk=on|abbr=on}}</nowiki>||{{convert|3.215|kg|lb|lk=on|abbr=on}}
|-
|小数点以下1桁となるよう四捨五入する場合||<nowiki>{{convert|3.215|kg|lb|1}}</nowiki>||{{convert|3.215|kg|lb|1}}
|-
|(変換後の単位を省略すると、最も一般的な単位に変換する)||<nowiki>{{Convert|7|lb}}</nowiki>||{{Convert|7|lb}}
|-
|誤差を併記する場合||<nowiki>{{convert|60|+/-|10|m|ft}}</nowiki>||{{convert|60|+/-|10|m|ft}}
|-
|複数単位への変換<br/>(スペースで区切って並べる)||<nowiki>{{convert|1|R|C F K}}</nowiki>||{{convert|1|R|C F K|lk=on}}
|}

範囲の指定:
{| class="wikitable"
!入力!!表示
|-
|<nowiki>{{convert|60|and|170|kg|lb}}</nowiki>||{{convert|60|and|170|kg|lb}}
|-
|<nowiki>{{convert|60|to|170|kg|lb}}</nowiki>||{{convert|60|to|170|kg|lb}}
|-
|<nowiki>{{convert|60|to(-)|170|kg|lb}}</nowiki>||{{convert|60|to(-)|170|kg|lb}}
|-
|<nowiki>{{convert|60|-|170|kg|lb}}</nowiki>||{{convert|60|-|170|kg|lb}}
|-
|<nowiki>{{convert|60|by|120|m|ft}}</nowiki>||{{convert|60|by|120|m|ft}}
|-
|<nowiki>{{convert|60|x|120|m|ft}}</nowiki>||{{convert|60|x|120|m|ft}}
|-
|<nowiki>{{convert|60|+/-|10|m|ft}}</nowiki>||{{convert|60|+/-|10|m|ft}}
|}

===変換精度===
変換後の精度は入力の精度に依存します。

{| class="wikitable"
!入力の精度!!記述例!!表示
|-
|1||<nowiki>{{convert|1|R|K}}</nowiki>||{{convert|1|R|K}}
|-
|1.0000||<nowiki>{{convert|1.0000|R|K}}</nowiki>||{{convert|1.0000|R|K}}
|-
|1.00000000||<nowiki>{{convert|1.00000000|R|K}}</nowiki>||{{convert|1.00000000|R|K}}
|}

{{Navbox Convert}}
<includeonly>{{Sandbox other||
<!-- カテゴリーはここに記載する -->
{{DEFAULTSORT:Convert}}
[[Category:単位関連のテンプレート]]
[[Category:数学関数テンプレート]]
[[Category:変換テンプレート]]
}}</includeonly>
<templatedata>
{
	"params": {
		"1": {
			"label": "数値",
			"type": "number",
			"required": true
		},
		"2": {
			"label": "変換元単位",
			"type": "content",
			"required": true
		},
		"3": {
			"label": "変換先単位",
			"type": "content",
			"required": true
		},
		"4": {
			"label": "小数点以下桁数",
			"type": "number"
		},
		"abbr": {
			"label": "単位略記",
			"type": "string",
			"autovalue": "on"
		},
		"lk": {
			"label": "単位リンク",
			"type": "boolean"
		}
	},
	"format": "inline"
}
</templatedata>