Template:Cardinal to word

Template documentation[view] [edit] [history] [purge]

Converts a given integer into a cardinal number or ordinal number in the English language. Anything between 10¹²⁶ and -10¹²⁶ is supported, as well as some larger numbers such as one centillion and one millinillion.

Usage

{{Number to word|integer[|zero=zero][|adj=on][|us=on][|ord=on]}}

integer: Required. A natural number in the range of 10¹²⁶ and -10¹²⁶ is, as well as some larger numbers such as one centillion and one millinillion.

zero: Optional. The value to use when the number is 0. Default is "zero" for cardinal numbers, "zeroth" for ordinal numbers. Can be made empty or, for example, "none", "seed" or "one before the first" as appropriate for the context.

adj: Optional. If the value is "on", the output is hyphenated.

ord: Optional. If the value is "on", the output is an ordinal number, otherwise it is a cardinal number.

us: Optional. If the value is "on", the output of numbers does not include "and" to separate hundreds from smaller values, nor to separate thousands from hundreds. This accords with American usage as described at English numerals.

Examples

Markup	Renders as
{{Number to word|-999999|adj=on}}	negative-nine-hundred-ninety-nine-thousand-nine-hundred-and-ninety-nine
{{Number to word|-1001|us=on}}	negative one thousand one
{{Number to word|-235|us=on|adj=on}}	negative-two-hundred-thirty-five
{{Number to word|-100}}	negative one hundred
{{Number to word|-30}}	negative thirty
{{Number to word|0|zero=not a sausage|adj=on}}	not-a-sausage
{{Number to word|30}}	thirty
{{Number to word|100}}	one hundred
{{Number to word|235|us=on|adj=on}}	two-hundred-thirty-five
{{Number to word|1001}}	one thousand and one
{{Number to word|999999|adj=on}}	nine-hundred-ninety-nine-thousand-nine-hundred-and-ninety-nine
{{Number to word|999999|adj=on|ord=on}}	nine-hundred-ninety-nine-thousand-nine-hundred-and-ninety-ninth
{{Number to word|9999999999999999}}	nine quadrillion nine hundred ninety-nine trillion nine hundred ninety-nine billion nine hundred ninety-nine million nine hundred ninety-nine thousand nine hundred and ninety-nine

See also

• Template:Ordinal to word — does the same job as this template with "ord" set to 1
• Template:Spellnum per MOS — wrapper of this template; applies guidance from BP:NUMERAL to determine when a number should be spelled out or not

The above documentation is transcluded from Template:Cardinal to word/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Please add categories to the /doc subpage. Subpages of this template.