https://afropedia.world/index.php?action=history&feed=atom&title=Template%3AConvert%2Fspell
Template:Convert/spell - Revision history
2026-06-23T09:30:00Z
Revision history for this page on the wiki
MediaWiki 1.45.1
https://afropedia.world/index.php?title=Template:Convert/spell&diff=5574&oldid=prev
Djehuti: 1 revision imported
2024-06-17T21:17:12Z
<p>1 revision imported</p>
<p><b>New page</b></p><div><!--<br />
-=============================================================<br />
- Template:Convert/spell - Convert and spell amount in words<br />
-=============================================================<br />
-- (see NOTES at bottom)<br />
-->{{#switch:{{{disp|b}}} <!--#1a--><br />
| out|2|output only|#|number =<br />
| #default = <!--else-show-inputs--<br />
=============================================== Show inputs<br />
------------------------------------ show amount 1<br />
-->{{#switch: {{{1|0}}}<br />
| 1/2 = {{#ifeq:{{{case|L}}}|u|O|o}}ne-half<br />
| 1/3 = {{#ifeq:{{{case|L}}}|u|O|o}}ne-third<br />
| 2/3 = {{#ifeq:{{{case|L}}}|u|T|t}}wo-thirds<br />
| 1/4 = {{<br />
#ifeq:{{{sp|en}}}|us<br />
| {{#ifeq:{{{case|L}}}|u|O|o}}ne-fourth<br />
| {{#ifeq:{{{case|L}}}|u|O|o}}ne-quarter}}<br />
| 3/4 = {{<br />
#ifeq:{{{sp|en}}}|us<br />
| {{#ifeq:{{{case|L}}}|u|T|t}}hree-fourths<br />
| {{#ifeq:{{{case|L}}}|u|T|t}}hree-quarters}}<br />
| 1/5 = {{#ifeq:{{{case|L}}}|u|O|o}}ne-fifth<br />
| 2/5 = {{#ifeq:{{{case|L}}}|u|T|t}}wo-fifths<br />
| 3/5 = {{#ifeq:{{{case|L}}}|u|T|t}}hree-fifths<br />
| 4/5 = {{#ifeq:{{{case|L}}}|u|F|f}}our-fifths<br />
| 1/6 = {{#ifeq:{{{case|L}}}|u|O|o}}ne-sixth<br />
| 5/6 = {{#ifeq:{{{case|L}}}|u|F|f}}ive-sixths<br />
| 1/8 = {{#ifeq:{{{case|L}}}|u|O|o}}ne-eighth<br />
| 3/8 = {{#ifeq:{{{case|L}}}|u|T|t}}hree-eighths<br />
| 5/8 = {{#ifeq:{{{case|L}}}|u|F|f}}ive-eighths<br />
| 7/8 = {{#ifeq:{{{case|L}}}|u|S|s}}even-eighths<br />
| 1/16 = {{#ifeq:{{{case|L}}}|u|O|o}}ne-sixteenth<br />
| 3/16 = {{#ifeq:{{{case|L}}}|u|T|t}}hree-sixteenths<br />
| 5/16 = {{#ifeq:{{{case|L}}}|u|F|f}}ive-sixteenths<br />
| 7/16 = {{#ifeq:{{{case|L}}}|u|S|s}}even-sixteenths<br />
| 9/16 = {{#ifeq:{{{case|L}}}|u|N|n}}ine-sixteenths<br />
| 11/16 = {{#ifeq:{{{case|L}}}|u|E|e}}leven-sixteenths<br />
| 13/16 = {{#ifeq:{{{case|L}}}|u|T|t}}hirteen-sixteenths<br />
| 15/16 = {{#ifeq:{{{case|L}}}|u|F|f}}ifteen-sixteenths<br />
| #default =<br />
{{spellnum|{{formatnum:{{{1|9500.12}}}|R}}<!--<br />
-->| case={{{case|L}}} <!--<br />
-->| sp={{{sp|us}}} <!--<br />
-->| adj={{{adj|off}}}<!--pass adjective mode<br />
-->}}<!--endspellnum<br />
-->}}<!--endswitch {1}<br />
------------------------------------------------ space/hyphen<br />
-->{{#ifeq:{{{adj|off}}}|off|<!--<br />
then-->{{<br />
#ifexpr:{{formatnum:{{{1|9999}}}|R}} > 999|&#32;|&nbsp;}}<!--<br />
else-->|-<!--put hyphen for adjective mode<br />
-->}}<!--endifeq {adj}=off<br />
--show-unit-->{{convert|{{{1|10}}}|{{{2|m}}}<!--<br />
-->|abbr=def<!-- don't use an abbreviation with spelt-out numbers<br />
-->|lk={{{lk|off}}}|adj={{{sing|{{{adj|off}}}}}}<!--<br />
-->|disp=unit|sp={{{sp|}}} }}<!--show unit<br />
=============================================== Mid-text if any<br />
-->{{#ifeq: {{{adj|off}}}|mid|<!--<br />
-->{{#ifeq:{{padleft:|1|{{{4|}}}}}|-||&#32;}}<!--<br />
-->{{{4|zzz}}}<!--show mid-text<br />
-->}}<!--endifeq {adj}=mid<br />
----------------------------------------------- Show separator<br />
-->{{#switch:{{{disp|b}}} <!--#1b--><br />
| b = &#32;(<br />
| br = <br/><br />
| sqbr = &#32;[<br />
| or = &#32;or&#32;<br />
| s|/ = &#32;/&#32;<br />
| comma = ,&#32;<br />
| semi|semicolon = &#59;&#32;<br />
| x = <b/>{{{4|zzz}}}<b/><br />
| #default = '''[[Template:Convert/spell|Convert/spell]] -<!--<br />
--> Invalid separator''' "disp={{{disp|xx}}}" - try: disp=s,<!--<br />
--> disp=or, disp=comma, disp=semi, disp=out, disp=number,<!--<br />
--> disp=x or disp=b.<br />
}}<!--endswitch {disp} #1b --><br />
}}<!--endsw {disp} #1a<br />
================================================= Show results<br />
-->{{formatnum: {{{{<!--insert commas if needed--><br />
#ifeq:{{{words|in}}}|out|spellnum|1x}}<!--spell number in result?<br />
-->|{{convert<br />
|{{formatnum:{{{1|9500.12}}}}}<!--endformatnum<br />
-->|{{{2|m}}}|{{<br />
#switch:{{{2|m}}}<br />
| cm = {{{3|in}}} | in = {{{3|cm}}}<br />
| ft = {{{3|m}}} | km = {{{3|mi}}}<br />
| m = {{{3|ft}}} | mi = {{{3|km}}}<br />
| #default = {{{3|0}}}<br />
}}<!--endsw {2}<br />
-->|{{#if:{{{r|}}}|{{{r|9}}}<!--allow r=round else...<br />
else-->|{{#ifeq:{{{adj|off}}}|mid|{{{5|}}}<!--<br />
else-->|{{#ifeq:{{{disp|b}}}|x|{{{6|}}}<!--<br />
else-->|{{{4|}}}<!--<br />
-->}}<!--endifeq disp=x<br />
-->}}<!--endifeq adj=mid<br />
-->}}<!--endif r<br />
-->|{{{5|}}}|{{{6|}}}<!--optional<br />
-->|disp=output number only<!--show result 4 & unit--<br />
-->|abbr=comma<!--use abbreviation-mode<br />
-->}}<!--endconvert of amount<br />
-->|prec={{#ifeq:{{#expr: 0*{{{4|a}}} }}|0<!--if {4} numeric<br />
then-->|{{{4|2}}}<!--precision as {4}--<br />
else-->|{{#if:{{{r|}}}<!--<br />
then-->|{{{r|}}}<!--use r=rounding<br />
else-->|{{precision<br />
|{{formatnum:{{{1|9500.12}}}|R}}}}<!--<br />
-->}}<!--endif {r}<br />
-->}}<!--endif {4} numeric<br />
-->| case=L <!--<br />
-->| adj={{{adj|off}}}<!--pass adjective mode<br />
-->}}<!--end 1x/spellnum #2<br />
-->}}<!--endformatnum<br />
--------------------------------------------------<br />
-->{{#switch:{{{disp|b}}} <!-- #2 --><br />
| number|#|output number only =<br />
| #default =<br />
&#32;<!--space<br />
-->{{convert|{{formatnum:{{{1|10,005.123}}}|R}}<!--endformatnum<br />
-->|{{{2|m}}}|{{{3|0}}}<!--<br />
-->|disp=u2<!--show result unit--<br />
-->|lk={{<br />
#switch:{{{lk|off}}}<!--condense link-mode as: off/on--><br />
| off|in = off<br />
| on|out = on<br />
}}<!--endsw{lk}--<br />
-->|abbr={{<!--use abbreviation-mode--><br />
#switch:{{{words|A{{{abbr|on}}}}}}<!--condense 7 values to off/on--><br />
| out|Anone|Aoff = off<!-- don't use abbr with spelt-out numbers --><br />
| on<br />
}}<!--endsw{abbr}--<br />
-->|adj={{{sing|{{{adj|off}}}}}}<!--use adjective-mode<br />
-->|r={{{sp|}}} }}<!--endconvert of amount<br />
-->}}<!--endsw {disp} #2<br />
-------------------------------------------------- show end text<br />
-->{{#switch:{{{disp|b}}} <!-- #3 --><br />
| b = )<br />
| sqbr = ]<br />
| x = <b/>{{{5|}}}<b/><br />
| #default =<br />
}}<!--endsw {disp} #3<br />
--><noinclude><!--<br />
-------------------------------------------------- Doc text--><br />
{| width=585px style="background:transparent;"<br />
| 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.<br />
:'''Usage''': &nbsp; &nbsp; {&#123;convert/spell |100|m|ft}}<br />
::::{&#123;convert/spell |1,234|km|mi|abbr=on}}<br />
::::{&#123;convert/spell |10.5|L|usgal|3}}<br />
::::{&#123;convert/spell |7|km|mi|case=u}}&nbsp; - words with upper-case letter<br />
::::{&#123;convert/spell |7|km|mi|disp=x|long (|)}} - custom output<br />
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=sqbr (square brackets), disp=b (default as parentheses), disp=2 (or disp=out) and disp=# (or disp=number).<br />
<br />
===Examples===<br />
The examples show various options of conversions:<br />
* {&#123;convert/spell |950|km|mi}}{{pad|2em}}&rarr; {{convert/spell |950|km|mi}}<br />
* {&#123;convert/spell |123|km|mi|abbr=on}}{{pad|1em}}&rarr; {{convert/spell |123|km|mi|abbr=on}}<br />
* {&#123;convert/spell |95.1|km|mi|lk=out}} &rarr; {{convert/spell |95.1|km|mi|lk=out}}<br />
* {&#123;convert/spell |140|ft|m|0}}{{pad|53px}}&rarr; {{convert/spell |140|ft|m|0}}<br />
* {&#123;convert/spell |140|ft|m|words=out}}{{pad|2px}}&rarr; {{convert/spell |140|ft|m|words=out}}<br />
* {&#123;convert/spell |140|ft|m|case=u }}{{pad|23px}}&rarr; {{convert/spell |140|ft|m|case=u }}<br />
* {&#123;convert/spell |140|ft|m|sp=en }}{{pad|23px}}&rarr; {{convert/spell |140|ft|m|sp=en }}<br />
* {&#123;convert/spell |1/2|ft|cm|words=out}}{{pad|2px}}&rarr; {{convert/spell |1/2|ft|cm|words=out}}<br />
* {&#123;convert/spell |1/2|mi}}{{pad|2px}}&rarr; {{convert/spell |1/2|mi}}<br />
<br />
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.<br />
<br />
===Common problems===<br />
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 {&#123;convert|spell|34|km}} will show "{{convert|spell|34|km}}".<br />
<br />
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.<br />
|}<!--<br />
--------------------------------------------------------------<br />
--NOTES<br />
--<br />
-- NOTE A1: This template converts numbers and spells the amount<br />
-- in words, using {spellnum|...} to display the words.<br />
-- It is a wrapper for Template:Convert, which is used<br />
-- 3 times for each conversion, to set the input unit<br />
-- name (or symbol), the output amount, and output unit.<br />
--<br />
-- NOTE S2: The value of any decimal portions are shifted,<br />
-- slightly, when displayed, to correct for any potential<br />
-- rounding errors when displaying the edit-digits of<br />
-- the decimal portion. The shift is only for display,<br />
-- and the amounts being converted are not shifted.<br />
--<br />
--------------------------------------------------------------<br />
--HISTORY:<br />
--14Apr2011 Created, from Convert/gaps to spell numbers.<br />
--14Apr2011 Put NOTES comments to explain template operation.<br />
--14Apr2011 Allowed disp=2 or disp=out to show output only.<br />
--14Apr2011 Allowed disp=# or disp=number to show only number.<br />
--24Apr2011 Allowed c=L for case=L & noted disp=br (brackets).<br />
--28Apr2011 Allowed options for adj=mid & disp=x.<br />
--28Apr2011 New option r=5 to set rounding level to 5 decimals.<br />
--02May2011 Formatted commas (if needed) in output number.<br />
--14May2011 Fixed adj=on or adj=mid to show hyphen "-".<br />
--18May2011 Fixed output unit symbol/name from param. {3}.<br />
--21May2011 Allow 20 fractions: 1/2, 1/3, 2/3, 1/4, 1/8...<br />
--12Jul2011 Defaulted {3} by {2} to avoid rounding as "|0".<br />
--12Jul2011 For spelling sp=en, uses "quarters" not "fourths".<br />
--12Jul2011 Defaulted case=L to show lower-case numbers.<br />
--16Jul2011 Fixed sp=us to show "-er" endings.<br />
--03Aug2011 Dissallow abbr with spelt out numbers per MOSNUM<br />
--><br />
<br />
[[Category:2011 Convert unit subtemplates]]<br />
[[Category:Extended Convert subtemplates]]<br />
</noinclude></div>
Djehuti