ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Convinfobox/doc

ᥢᥣᥲᥘᥤᥐᥲᥟᥢᥴᥢᥭᥳᥢᥭᥳ ᥛᥢᥰᥙᥥᥢᥴ ᥚᥪᥢᥴᥐᥦᥛᥴᥛᥪᥰ ᥘᥣᥭᥰᥓᥬᥳᥖᥪᥰ (documentation) ᥞᥒᥰ ᥖᥩᥢᥲᥖᥣᥱ ᥢᥣᥲᥘᥤᥐᥲᥚᥦᥴ (subpage) ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Convinfobox ᥢᥢᥳᥕᥝᥴ။
ᥖᥤᥲᥢᥣᥲᥘᥤᥐᥲᥟᥢᥴᥢᥭᥳᥢᥭᥳ ᥛᥢᥰᥖᥥᥴᥑᥝᥲᥙᥣᥰᥝᥭᥳ ᥘᥣᥭᥰᥓᥬᥳᥖᥪᥰ ᥘᥦᥲ ᥑᥩᥲᥑᥣᥝᥱᥟᥢᥴᥐᥥᥝᥱᥐᥙᥴး၊ ᥙᥫᥒᥴᥗᥣᥢᥴ ᥘᥦᥲ ᥑᥩᥲᥛᥧᥢᥰᥖᥣᥒᥱᥓᥫᥰ ᥟᥢᥴᥟᥛᥱᥐᥥᥝᥱᥐᥙᥰ ᥖᥒᥰ ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ page ᥢᥢᥳᥕᥝᥳ။

This template is used on many pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Uses Lua:

Module:ConvertIB

This template is a frontend for {{convert}}. It is intended as a meta-template for use within the code for a template, where the input is not known a priori. For unit conversions within articles, one should use {{convert}} directly.

This template accepts from four to seven unnamed parameters. Odd parameters must be numerical (or empty) and specify the numerical value of a measurement and the intended precision of the conversion. Even parameters must be unit codes as used in ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Tlf. Named parameters are the same as used by ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Tlf.

This template differs from ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Tlf in the following respects.

The units to convert to and the units to convert from must be specified (therefore there are no default convert-to units).
Fields for the numerical value of a measurement may be left blank.
The default is to abbreviate units (where abbreviations exist).
Range conversions are not available.

This template may be used when it is unknown in which direction the conversion is to be made. The direction is determined as shown in the following examples.

{{convinfobox|100|m2||sqft}} → ႑႐႐ m² (႑,႑႐႐ sq ft)
{{convinfobox||m2|100|sqft}} → ႑႐႐ sq ft (႙.႓ m²)

Dual conversions

Dual conversions may be performed by adding a fifth (possibly blank) and sixth unnamed parameter.

{{convinfobox|375|ml||impoz||USoz}} → ႓႗႕ ml (႑႓.႒ imp fl oz; ႑႒.႗ US fl oz)
{{convinfobox||ml|40|impoz||USoz}} → ႔႐ imp fl oz (႑,႑႐႐ ml; ႓႘ US fl oz)
{{convinfobox||ml||impoz|32|USoz}} → ႓႒ US fl oz (႙႕႐ ml; ႓႓ imp fl oz)

Paired units

Length may be expressed in feet and inches.

{{convinfobox|180|cm||ft||in}} → ႑႘႐ cm (႕ ft ႑႑ in)
{{convinfobox||cm|5|ft||in}} → ႕ ft ႐ in (႑႕႒ cm)
{{convinfobox||cm||ft|120|in}} → ႑႒႐ in (႓႐႐ cm)
{{convinfobox||cm|5|ft|6|in}} → ႕ ft ႖ in (႑႖႘ cm)
{{convinfobox||ft||in|180|cm}} → ႑႘႐ cm (႕ ft ႑႑ in)
{{convinfobox|5|ft||in||cm}} → ႕ ft ႐ in (႑႕႒ cm)
{{convinfobox||ft|120|in||cm}} → ႑႒႐ in (႓႐႐ cm)
{{convinfobox|5|ft|6|in||cm}} → ႕ ft ႖ in (႑႖႘ cm)

Similarly, mass may be expressed in pounds and ounces.

{{convinfobox|8.5|kg||lb||oz}} → ႘.႕ kg (႑႘ lb ႑႒ oz)
{{convinfobox||kg|4|lb|3|oz}} → ႔ lb ႓ oz (႑.႙ kg)

Mass may also be expressed in stone and pounds.

{{convinfobox|65|kg||st||lb}} → ႖႕ kg (႑႔႓ lb; ႑႐ st ႓ lb)
{{convinfobox||kg|10|st||lb}} → ႑႐ st ႐ lb (႖႔ kg; ႑႔႐ lb)
{{convinfobox||kg|10|st|7|lb}} → ႑႐ st ႗ lb (႖႗ kg; ႑႔႗ lb)
{{convinfobox||kg||st|145|lb}} → ႑႔႕ lb (႖႖ kg; ႑႐ st ႕ lb)

Specifying more than one value

The template currently bases conversions on the first non-blank numerical value ignoring any secondary or tertiary values.

{{convinfobox|100|m2|100|sqft}} → ႑႐႐ m² (႑,႑႐႐ sq ft)
{{convinfobox|375|ml|40|impoz||USoz}} → ႓႗႕ ml (႑႓.႒ imp fl oz; ႑႒.႗ US fl oz)
{{convinfobox|375|ml||impoz|32|USoz}} → ႓႗႕ ml (႑႓.႒ imp fl oz; ႑႒.႗ US fl oz)
{{convinfobox||ml|40|impoz|32|USoz}} → ႔႐ imp fl oz (႑,႑႐႐ ml; ႓႘ US fl oz)

Rounding

As with ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Tlf rounding can be done automatically or manually by specifying the precision and/or number of significant figures in the converted value. The number of significant figures can be determined by the parameter |sigfig=. The precision can be determined by the fifth (if there is no sixth) or seventh (if there is a sixth) unnamed parameter as shown in the examples below.

{{convinfobox|100|m2||sqft|4}} → ႑႐႐ m² (႑,႐႗႖.႓႙႑႐ sq ft)
{{convinfobox|100|m2||sqft|sigfig=4}} → ႑႐႐ m² (႑,႐႗႖ sq ft)
{{convinfobox||ml|40|impoz||USoz|2}} → ႔႐ imp fl oz (႑,႑႓႖.႕႒ ml; ႓႘.႔႓ US fl oz)
{{convinfobox||ml|40|impoz||USoz|sigfig=3}} → ႔႐ imp fl oz (႑,႑႔႐ ml; ႓႘.႔ US fl oz)
{{convinfobox||kg|10|st|7|lb|3}} → ႑႐ st ႗ lb (႖႖.႖႗႘ kg; ႑႔႗.႐႐႐ lb)
{{convinfobox||kg|10|st|7|lb|sigfig=5}} → ႑႐ st ႗ lb (႖႖.႖႗႘ kg; ႑႔႗.႐႐ lb)

Specify precision "0" to prevent rounding of values ending in zero:

kilograms (kg)
- with "0": {{convinfobox|110|kg||lb|0}} → ႑႑႐ kg (႒႔႓ lb)
- without: {{convinfobox|110|kg||lb}} → ႑႑႐ kg (႒႔႐ lb)
pounds (lb)
- with "0": {{convinfobox||kg|240|lb|0}} → ႒႔႐ lb (႑႐႙ kg)
- without: {{convinfobox||kg|240|lb}} → ႒႔႐ lb (႑႑႐ kg)
metres (m)
- with "0": {{convinfobox|100|m||ft|0}} → ႑႐႐ m (႓႒႘ ft)
- without: {{convinfobox|100|m||ft}} → ႑႐႐ m (႓႓႐ ft)
inches (in)
- with "0": {{convinfobox||cm|100|in|0}} → ႑႐႐ in (႒႕႔ cm)
- without: {{convinfobox||cm|100|in}} → ႑႐႐ in (႒႕႐ cm)

Leaving all numerical fields blank

If all numerical value fields are left blank the template returns nothing.

{{convinfobox||m2||sqft}} →
{{convinfobox||ml||impoz||USoz}} →

ᥖᥨᥭᥰᥙᥣᥰ

Supporting templates

Template:Convert (invokes Module:Convert)

Templates transcluding {{convinfobox}}

ᥔᥥᥢᥲᥛᥣᥭᥴ

ᥗᥦᥛᥰ ᥙᥣ ᥘᥥᥐᥳ:Math templates