Template:Convert/doc: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Caesar Schinas
imported>Caesar Schinas
(→‎Rounding: Rounding now explained above. Replace with general examples.)
Line 18: Line 18:
</div>
</div>


==Rounding==
== Examples ==
{{tl|Convert}} has an additional parameter that controls roundin. More specifically, it controls how many places after the decimal are displayed. To use this feature, add a value in the fourth parameter. For example <nowiki>{{Convert|10|km|mi|5}}</nowiki> shows up to the fifth decimal place, displaying as {{Convert|10|km|mi|5}}.
===Examples===
<nowiki>{{Convert|547.3|km|mi|0}}</nowiki> hides the decimals, displaying as {{Convert|547.3|km|mi|0}}.


<nowiki>{{Convert|547.3|km|mi|1}}</nowiki> shows one decimal, displaying as {{Convert|547.3|km|mi|1}}
{| class="wikitable"
 
! Code !! Result !! Notes
<nowiki>{{Convert|547.3|km|mi|2}}</nowiki> shows two decimals, displaying as {{Convert|547.3|km|mi|2}}
|-
 
|{{tlc|convert|123.4{{!}}km{{!}}mi}}
<nowiki>{{Convert|547.3|km|mi|3}}</nowiki> shows three decimals, displaying as {{Convert|547.3|km|mi|3}}
|{{convert|123.4|km|mi}}
 
|Simple conversion of 123.4 kilometres to miles.
<nowiki>{{Convert|547.3|km|mi|10}}</nowiki> shows ten decimals, displaying as {{Convert|547.3|km|mi|10}}
|-
|{{tlc|convert|12{{!}}in{{!}}cm}}
|{{convert|12|in|cm|0}}
|Convert 12 in to cm, rounding to the nearest whole cm.
|-
|{{tlc|convert|60{{!}}nmi{{!}}mi}}
|{{convert|60|nmi|mi|6}}
|Convert 60 nautical miles to statute miles, showing the result to 6 decimal places.
|-
|{{tlc|convert|60{{!}}nmi{{!}}mi}}
|{{convert|60|nautical miles|miles|-1}}
|Convert 60 nautical miles to statute miles, and round the result to one significant figure.
|}


==Parameters That Need to be Created==
==Parameters That Need to be Created==

Revision as of 02:29, 16 June 2009

This template is used in articles to easily convert one unit to another. This template will always be under construction, as we can’t possibly include conversions ‘’from’’ every possible unit ‘’to’’ every possible unit. However, whenever a conversion isn’t supported, I or any of the other users who have worked on this template would be happy to add conversions when brought to our attention. The goal of this template is to make the Citizendium accessible to all readers regardless of nationality. Instead of only showing SI/Metric units or Imperial units, {{convert}} automatically converts a number from the specified unit to another unit and displays it as "Metric (Imperial)" or "Imperial (Metric)", depending on which unit was converted from.

Usage

The template has four parameters - {{convert|number|from|to|precision}}.

  1. required — The number to convert.
  2. required — The unit to convert from.
  3. required — The unit to convert to.
  4. optional — The precision of the result. Positive values cause the specified number of decimal places to be shown, whilst negative values cause the numbers to be rounded to the specified number of significant figures. The default value is 2 (2 decimal places).

The names of the units can be specified as either abbreviations or full words, using either British or American spelling. The unit names in the output will be in the same format as the input.

Supported Conversions

Transcluded from Template:Convert/doc/conversions (edit)

Length Conversions

Metric to Imperial

Inches (in) Feet (ft) Yards (yd) Miles (mi) Nautical Miles (nmi)
Millimetres (mm) Yes Yes No No No
Centimetres (cm) Yes Yes No No No
Decimetres (dm) Yes Yes No No No
Metres (m) Yes Yes Yes Yes Yes
Kilometres (km) No No Yes Yes Yes

Imperial to Metric

Millimetres (mm) Centimetres (cm) Decimetres (dm) Metres (m) Kilometres (km)
Inches (in) Yes Yes Yes Yes No
Feet (ft) Yes Yes Yes Yes Yes
Yards (yd) Yes Yes Yes Yes Yes
Miles (mi) No No No Yes Yes
Nautical Miles (nmi) No No No Yes Yes

Imperial to Imperial

Miles (mi) Nautical Miles (nmi)
Miles (mi) - Yes
Nautical Miles (nmi) Yes -

Weight Conversions

Kilogrammes (kg) Grammes (g) Pounds (lbs) Ounces (oz)
Kilogrammes (kg) - No Yes Yes
Grammes (g) No - Yes Yes
Pounds (lbs) Yes Yes - No
Ounces (oz) Yes Yes No -

Temperature Conversions

Celsius (°C) Kelvin (°K) Fahrenheit (°F) Rankine (°R)
Celsius (°C) - Yes Yes Yes
Kelvin (°K) Yes - Yes No
Fahrenheit (°F) Yes Yes - Yes
Rankine (°R) Yes No Yes -

Examples

Code Result Notes
{{convert|123.4|km|mi}} 123.4 km (76.68 mi) Simple conversion of 123.4 kilometres to miles.
{{convert|12|in|cm}} 12 in (30 cm) Convert 12 in to cm, rounding to the nearest whole cm.
{{convert|60|nmi|mi}} 60 nmi (69.046767 mi) Convert 60 nautical miles to statute miles, showing the result to 6 decimal places.
{{convert|60|nmi|mi}} 60 nautical miles (70 miles) Convert 60 nautical miles to statute miles, and round the result to one significant figure.

Parameters That Need to be Created

Add units of measurement, and their conversion formulas, that still need to be created here