Template:Convert/spell

From WikiSwire
Jump to navigation Jump to search

nine thousand five hundred point one two metres (31,168.4 ft)

The converter Template:Convert/spell will convert an amount and display the amount spelled in words. The resulting 2nd amount will be shown using a numeral ("330 ft"), unless option words=out is used. To set the rounding precision, the output unit must be specified, or put "0" to default.
Usage:     {{convert/spell |100|m|ft}}
{{convert/spell |1,234|km|mi|abbr=on}}
{{convert/spell |10.5|L|usgal|3}}
{{convert/spell |7|km|mi|case=u}}  - words with upper-case letter
{{convert/spell |7|km|mi|disp=x|long (|)}} - custom output

Use case=u to show an upper-case letter (capital letter) in the number. The template allows the same parameters as Template:Convert, and so it allows abbreviation abbr=in or abbr=out or abbr=none, wikilinks lk=in or lk=out, and adjective mode adj=on or adj=mid. The separator can also be a semicolon: disp=semi, disp=or, disp=comma, disp=x (customized), disp=br (brackets), disp=b (default as parentheses), disp=2 (or disp=out) and disp=# (or disp=number).

Examples

The examples show various options of conversions:

  • {{convert/spell |950|km|mi}} → nine hundred fifty kilometres (590 mi)
  • {{convert/spell |123|km|mi|abbr=on}} → one hundred twenty-three kilometres (76 mi)
  • {{convert/spell |95.1|km|mi|lk=out}} → ninety-five point one kilometres (59.1 mi)
  • {{convert/spell |140|ft|m|0}} → one hundred forty feet (43 m)
  • {{convert/spell |140|ft|m|words=out}} → one hundred forty feet (forty-three metres)
  • {{convert/spell |140|ft|m|case=u }} → One hundred forty feet (43 m)
  • {{convert/spell |140|ft|m|sp=en }} → one hundred and forty feet (43 m)
  • {{convert/spell |1/2|ft|cm|words=out}} → one-half foot (fifteen centimetres)
  • {{convert/spell |1/2|mi}} → one-half mile (0.80 km)

Display types: disp=comma, disp=semi, disp=or, disp=out, disp=number, disp=x and disp=b. The numeric results are identical to using Template:Convert to show numerals instead of words.

Common problems

Note the name of this template is "convert/spell" and omitting the suffix "/spell" will not show words for numbers. Also, putting "spell" as parameter 1 will cause the number to be treated as a template name "Convert/<number>" such as {{convert|spell|34|km}} will show "Template:Convert/34".

The amount is followed by a unit-code (such as "|m") as the 2nd parameter. The output unit-code can be "0" as the 3rd parameter, to allow the default output unit to be triggered, while setting parameter 4 to a rounding precision (such as "|5") or use r=5 to set the rounding level.