Template:Unit km

From Wikipedia, the free encyclopedia

Displays kilometres (km) and converts it to miles (mi) for example "{{Unit km | 48.7 | 1}}" appears as "48.7 km (30.3 mi)" with rounding to 1 decimal place.

Usage

This template is one of the unit display category of templates. These are templates which print figures with their units and converts them to either English or metric system too. The second value is in brackets. Both parameters should be unformated numbers, the first one is the actual value, the second one is the number of decimal digits for the calculated value. The numbers are then nicely formated.

If you append "| lk=on" to the template the units will be wikilinked, otherwise they will not be. The manual of style suggests that you only link the first instance.

The Manual of Style Units Section specifies that you should spell out the primary unit in text therefore you should use the full version (where available) e.g. {{Unit foot}}, in sentences and the abbreviated version e.g. {{Unit ft}} in tables, info boxes, etc.

If the grammar of a sentence requires that the singular version of a spelled out unit is required append "| sing=on" to the template.

Examples:

  • {{Unit km | 1487.27 }} renders as: 1,487.27 km (924.146733079 mi)
  • {{Unit mi | 1487.27 | 2}} renders as: 1,487.27 mi (2,393.53 km)
  • {{Unit sqkm | 1487.27 | 2 | lk=on }} renders as: 1,487.27 km² (574.24 sq mi)
  • {{Unit foot | 1487.27 | 2 }} renders as: 1,487.27 feet (453.32 m)
  • {{Unit foot | 1487.27 | 2 | sing=on }} renders as: 1,487.27 foot (453.32 m)
  • {{Unit metre | 1487.27 | 2 | lk=on }} renders as: 1,487.27 metres (4,879.49 ft)
  • {{Unit metre | 1487.27 | 2 | lk=on | sing=on }} renders as: 1,487.27 metre (4,879.49 ft)

It is important to note that negative values are OK for the rounding parameter, which is very useful for converting approximate values:

  • {{Unit ft | 14000 | 0}} renders as: 14,000 ft (4,267 m)
  • {{Unit ft | 14000 | -1}} renders as: 14,000 ft (4,270 m)
  • {{Unit ft | 14000 | -2}} renders as: 14,000 ft (4,300 m)

[edit] See also