Template:Hands/doc
 | This is a documentation subpage for Template:Hands. It may contain usage information, categories and other content that is not part of the original template page. |
A hand is a unit of length used to measure the height of horses and ponies. One hand is four inches, and a value of '12.3 hands' represents 12 hands + 3 inches (51 inches). This template converts hands into the equivalent heights in inches and centimetres.
Note: with hands, any fractional part (numbers and vulgar fractions after the period) are inches, not a decimal fraction of a hand. Hence '14.2 hands' means 14 hands, 2 inches, not 14+2⁄10 hands.
Usage
Basic usage:
- <syntaxhighlight lang="wikitext" inline>14.2 hands (58 inches, 147 cm)</syntaxhighlight> → 14.2 hands (58 inches, 147 cm)
The optional parameters include:|abbr=on to show "h" (or |abbr=hh to show "hh"), |r=2 to round inches and cm to 2 decimal places, |rinch=2 to round the inches only, or |rcm=2 to round the centimeters only, |lk=off to unlink the hands unit.
| Input | Output |
|---|---|
| <syntaxhighlight lang="wikitext" inline>14.2 hands (58 inches, 147 cm)</syntaxhighlight> | 14.2 hands (58 inches, 147 cm) |
| <syntaxhighlight lang="wikitext" inline>14.1 3⁄4 hands (57.75 inches, 147 cm)</syntaxhighlight> | 14.1 3⁄4 hands (57.75 inches, 147 cm) |
| <syntaxhighlight lang="wikitext" inline>15.3 hands (63 inches, 160 cm)</syntaxhighlight> | 15.3 hands (63 inches, 160 cm) |
| <syntaxhighlight lang="wikitext" inline>15.3 h (63 inches, 160 cm)</syntaxhighlight> | 15.3 h (63 inches, 160 cm) |
| <syntaxhighlight lang="wikitext" inline>15.3 hh (63 inches, 160 cm)</syntaxhighlight> | 15.3 hh (63 inches, 160 cm) |
| <syntaxhighlight lang="wikitext" inline>14.1 1⁄2 hands (57.5 inches, 146 cm)</syntaxhighlight> | 14.1 1⁄2 hands (57.5 inches, 146 cm) |
| <syntaxhighlight lang="wikitext" inline>14.1 1⁄2 hands (58 inches, 146 cm)</syntaxhighlight> | 14.1 1⁄2 hands (58 inches, 146 cm) |
| <syntaxhighlight lang="wikitext" inline>14.1 1⁄2 hands (57.5 inches, 146.1 cm)</syntaxhighlight> | 14.1 1⁄2 hands (57.5 inches, 146.1 cm) |
| <syntaxhighlight lang="wikitext" inline>14.1 1⁄2 hands (57.5 inches, 146.05 cm)</syntaxhighlight> | 14.1 1⁄2 hands (57.5 inches, 146.05 cm) |
| <syntaxhighlight lang="wikitext" inline>14.1 1⁄2 hands (58 inches, 146 cm)</syntaxhighlight> | 14.1 1⁄2 hands (58 inches, 146 cm) |
| <syntaxhighlight lang="wikitext" inline>14.1 1⁄2 hands (57.5 inches, 146.05 cm)</syntaxhighlight> | 14.1 1⁄2 hands (57.5 inches, 146.05 cm) |
| <syntaxhighlight lang="wikitext" inline>15.1–16.3 hands (61–67 inches, 155–170 cm)</syntaxhighlight> | 15.1–16.3 hands (61–67 inches, 155–170 cm) |
| <syntaxhighlight lang="wikitext" inline>14.2 to 16.1 hands (58 to 65 inches, 147 to 165 cm)</syntaxhighlight> | 14.2 to 16.1 hands (58 to 65 inches, 147 to 165 cm) |
| <syntaxhighlight lang="wikitext" inline>14.2 any text here 16.1 hands (58 any text here 65 inches, 147 any text here 165 cm)</syntaxhighlight> | 14.2 any text here 16.1 hands (58 any text here 65 inches, 147 any text here 165 cm) |
If the 'range' format is used, the text in the second parameter (such as "to") can take any text you wish to use, such as 'and', 'to' or <syntaxhighlight lang="wikitext" inline>–</syntaxhighlight>. When the range has a hyphen/dash or comma, then some spaces are omitted.
Hands can also be converted using {{convert}}, for example
- <syntaxhighlight lang="wikitext" inline>15.3 hands (63 inches; 160 cm)</syntaxhighlight> → 15.3 hands (63 inches; 160 cm); or
- <syntaxhighlight lang="wikitext" inline>63 inches; 160 centimetres (15.3 h)</syntaxhighlight> → 63 inches; 160 centimetres (15.3 h)
This could be useful when <syntaxhighlight lang="wikitext" inline>[convert: needs a number]</syntaxhighlight> units or options are needed that are not in <syntaxhighlight lang="wikitext" inline>1.1 hands (5 inches, 13 cm)</syntaxhighlight>, such as the illustrated |order=flip.
Inverse
To convert other measurements into hands, use {{convert}}:
- Convert from cm: <syntaxhighlight lang="wikitext" inline>148 to 152 centimetres (14.2+1⁄2 to 15.0 hands; 58+1⁄2 to 60 in)</syntaxhighlight> → 148 to 152 centimetres (14.2+1⁄2 to 15.0 hands; 58+1⁄2 to 60 in)
- Convert from inches: <syntaxhighlight lang="wikitext" inline>60 to 62 inches (15.0 to 15.2 hands; 152.40 to 157.48 cm)</syntaxhighlight> → 60 to 62 inches (15.0 to 15.2 hands; 152.40 to 157.48 cm)
Using a full three-way conversion (hands, inches and centimeters) in all cases is strongly recommended, regardless of which measurement is given first.
Singular use (not recommended):