View source for Template:Long ton/doc

{{Documentation subpage}}
==Usage==
This template is intended to allow entry of imperial weights ([[Avoirdupois#Post-Elizabethan|Avoirdupois]]), measured in tons, [[long hundredweight|hundredweights]], quarters and/or pounds (ton, cwt, qr and/or lb) and provide a conversion into pounds and into tonnes (metric tons) or kilograms (if the first parameter is blank or zero).

This format is traditional for the specification of locomotive and bells cast manufactured or used in the UK and some other Commonwealth countries. See [http://dove.cccbr.org.uk/doveDesc.php Dove's Bellringers' Guide].

===Syntax===
*<code><nowiki>{{long ton |tons |cwt |qr |lb }}</nowiki></code>
*<code><nowiki>{{long ton</nowiki> |35{{ns|3}}|4{{ns|3}}|2{{ns|2}}|1{{ns|2}}}}</code> &rarr;
:: {{long ton |35 |4 |2 |1 }}

:To link the "long" unit to article ''[[Long ton]]'' use {{para|lk|on}}:
*<code><nowiki>{{long ton |tons |cwt |qr |lb |lk=on }}</nowiki></code>
*<code><nowiki>{{long ton</nowiki> |35{{ns|3}}|4{{ns|3}}|2{{ns|2}}|1{{ns|2}}|lk=on }}</code> &rarr;
::{{long ton |35 |4 |2  |1 |lk=on }}

Only the second parameter, the number of cwt, is required; all the others are optional. Note that the first parameter must be empty then.
*<code><nowiki>{{long ton | |cwt }}</nowiki></code>
*<code><nowiki>{{long ton | |100 }}</nowiki></code> &rarr;
::{{long ton | |100 }}
*<code><nowiki>{{long ton | |100 |lk=on }}</nowiki></code> &rarr;
::{{long ton | |100 |lk=on}}

;Unit names or symbols
There is no option to write full names of the units. The units are written: <code>{{nowrap|long ton[s], [long] cwt, qr, lb}}</code>. (Where {{tlf|convert}} has {{para|abbr|off/on}}).

===Rounding===
Rounding depends on input.

*If pounds are specified in input, the output value for pounds will be given to the nearest pound and the metric conversion will be to the nearest kilogram.
*If pounds are not specified in input but quarters are, the output value for pounds will be given to the nearest 10 pounds and the metric conversion will be to the nearest 10 kilograms.
*If neither pounds nor quarters are specified in input, the output value for pounds will be given to the nearest 100 pounds and the metric conversion will be to the nearest 100 kilograms.

===Display===
Inside grammatical brackets, use <code>disp=or</code> or <code>disp=sqbr</code>: 

<code>A replacement ring of ten bells (tenor <nowiki>{{</nowiki>long ton||18|1|2|disp=or}})</code>
::gives: "A replacement ring of ten bells (tenor {{long ton||18|1|2|disp=or}})"
<code>A replacement ring of ten bells (tenor <nowiki>{{</nowiki>long ton||18|1|2|disp=sqbr}})</code>
::gives: "A replacement ring of ten bells (tenor {{long ton||18|1|2|disp=sqbr}})"

===In tables===
Use <code>disp=table</code> in tables.

<pre>
 {| class="wikitable"
 |-
 ! rowspan=2| Number
 ! rowspan=2| Date
 ! rowspan=2| Maker
 ! colspan=3| Mass
 |-
 ![[long ton|long measure]]
 !lb
 !kg
 |-
 | 1st || 1891 || Mears & Stainbank
 |{{long ton||7|3|12|disp=table}}
 |-
 | 2nd || 1891 || Mears & Stainbank
 |{{long ton||9|0|2|disp=table}}
 |-
 |3rd || 1757 || Abel Rudhall
 |{{long ton||10|0|0|disp=table}}
 |}
</pre>
::gives
{| class="wikitable"
 |-
 ! rowspan=2| Number
 ! rowspan=2| Date
 ! rowspan=2| Maker
 ! colspan=3| Mass
 |-
 ![[long ton|long measure]]
 !lb
 !kg
 |-
 | 1st || 1891 || Mears & Stainbank
 |{{long ton||7|3|12|disp=table}}
 |-
 | 2nd || 1891 || Mears & Stainbank
 |{{long ton||9|0|2|disp=table}}
 |-
 |3rd || 1757 || Abel Rudhall
 |{{long ton||10|0|0|disp=table}}
 |}

===References and footnotes===
Use <code>ref=</code> to add a reference or footnote.

<code><nowiki>{{long ton|3|18|1|2|ref=<ref>some source</ref></nowiki>}}</code>
::gives: "{{long ton|3|18|1|2|ref=<ref>some source</ref>}}"

{{reflist}}

===Examples===
For example:
*<code>Locomotive weight: <nowiki>{{long ton|35|4}}</nowiki>.</code>
::gives:  "Locomotive weight: {{long ton|35|4}}."

*<code>Locomotive weight: <nowiki>{{long ton|35|4|2}}</nowiki>.</code>
::gives:  "Locomotive weight: {{long ton|35|4|2}}."

*<code>Locomotive weight: <nowiki>{{long ton|35|4|2|lk=on}}</nowiki>.</code>
::gives:  "Locomotive weight: {{long ton|35|4|2|lk=on}}."

*<code>Locomotive weight: <nowiki>{{long ton|35|4|2|lk=cwt}}</nowiki>.</code>
::gives:  "Locomotive weight: {{long ton|35|4|2|lk=cwt}}."

*<code>Locomotive weight: <nowiki>{{long ton|35|4|2|lk=on}}</nowiki>.</code>
::gives:  "Locomotive weight: {{long ton|35|4|2|lk=on}}."

*<code>The old tenor weighed <nowiki>{{long ton||21|2|12}}</nowiki>.</code>
::gives:  "The old tenor weighed {{long ton||21|2|12}}."

*<code>The recast tenor now weighs <nowiki>{{long ton|0|20|3|7|lk=on}}</nowiki>.</code>
::gives:  "The recast tenor now weighs {{long ton||20|3|7|lk=on}}."

== Conversion table ==

{| class="wikitable"
|+ Table of mass units
|-
! Unit
! Relative<br>value
! Metric<br>value
! Notes
|-
| style="text-align:center;" | dram or drachm (dr)
| style="text-align:right;" | {{frac|1|256}}
| style="text-align:left;" | ≈ {{convert|1/256|lb|g|sigfig=4|disp=output only}}
| style="text-align:right;" | {{frac|1|16}} oz
|-
| style="text-align:center;" | ounce (oz)
| style="text-align:right;" | {{frac|1|16}}
| style="text-align:left;" | ≈ {{convert|1/16|lb|g|sigfig=4|disp=output only}}
| style="text-align:right;" | 16 dr
|-
| style="text-align:center;" | pound (lb)
| style="text-align:right;" | 1
| style="text-align:left;" | ≈ {{convert|1|lb|g|sigfig=4|disp=output only}}
| style="text-align:right;" | 16 oz
|-
| style="text-align:center;" | stone (st)
| style="text-align:right;" | 14
| style="text-align:left;" | ≈ {{convert|14|lb|kg|sigfig=4|disp=output only}}
| style="text-align:right;" | {{frac|2}} qr
|-
| style="text-align:center;" | quarter (qr)
| style="text-align:right;" | 28
| style="text-align:left;" | ≈ {{convert|28|lb|kg|sigfig=4|disp=output only}}
| style="text-align:right;" | 2 st
|-
| style="text-align:center;" | hundredweight (cwt)
| style="text-align:right;" | 112
| style="text-align:left;" | ≈ {{convert|112|lb|kg|sigfig=4|disp=output only}}
| style="text-align:right;" | 4 qr
|-
| style="text-align:center;" | ton (t)<br>or<br>long ton (l. tn.)
| style="text-align:right;" | 2,240
| style="text-align:left;" | ≈ {{convert|2240|lb|kg|sigfig=4|disp=output only}}
| style="text-align:right;" | 20 cwt
|}

==Template Data==
{{Template data header}}
<templatedata>
{
	"params": {
		"1": {},
		"2": {},
		"3": {},
		"4": {},
		"disp": {},
		"lk": {},
		"ref": {}
	},
	"paramOrder": [
		"1",
		"2",
		"3",
		"4",
		"disp",
		"lk",
		"ref"
	]
}
</templatedata>

==See also==
{{Math templates|conversion}}

<includeonly>{{Sandbox other||
[[Category:Conversion templates]]
[[Category:Convert-like templates|{{SUBPAGENAME}}]]

}}</includeonly>