Number to Words

Convert a numeric to a string with the English name of the number value (GB/IN/US).

NUM2WORDS converts a numeric scalar to text with the number value written in English words: for example the numeric scalar 1024 is returned as the text 'one thousand and twenty-four'. NUM2WORDS accepts a scalar of any standard numeric class: single, double, intX, or uintX. Integer types are parsed with their full precision, while floating types have internal precision limits to ensure the least-unexpected output. Options allows the user to select:

• the output class: char or string.
• the number type selection: ordinal / decimal / cheque / money / highest magnitude.
• the number of significant digits or order-of-magnitude.
• upper / lower / title / sentence case.
• trailing zeros or without.
• the use of a comma between magnitude groups.
• the use of a hyphen between tens and ones.
• the use of 'and' before the tens/ones (required in British and Commonwealth English).
• a 'positive' prefix for non-negative values.
• the numbering scale: short / long / Indian / Peletier / Rowlett / yllion.
• currency unit names, e.g. Pound, Pence, Dollar, Cents, Rupees, etc.

Dependencies

None

Bonus Functions / Scripts

• NUM2WORDS_TEST contains thousands of test cases.
• NUM2WORDS_DEMO compares the output of NUM2WORDS against real-world examples.
• NUM2WORDS_RAT converts a numeric to a string with an improper fraction in words.

Reverse Conversion

http://www.mathworks.com/matlabcentral/fileexchange/52925-words-to-number

Examples

>> num2words(0)
ans = 'zero'

>> num2words(1024)
ans = 'one thousand and twenty-four'
>> num2words(-1024)
ans = 'negative one thousand and twenty-four'
>> num2words(1024, 'pos',true, 'case','title', 'hyphen',false)
ans = 'Positive One Thousand and Twenty Four'
>> num2words(1024, struct('type','ordinal', 'case','sentence'))
ans = 'One thousand and twenty-fourth'
>> num2words(1024, 'and',false, 'order',1) % round to the tens.
ans = 'one thousand twenty'

>> num2words(pi, 'order',-10) % round to tenth decimal digit
ans = 'three point one four one five nine two six five three six'

>> num2words(intmax('uint32'), 'sigfig',4, 'type','highest')
ans = 'four point two nine five billion'
>> num2words(intmax('uint32'), 'sigfig',4, 'comma',false)
ans = 'four billion two hundred and ninety-five million'
>> num2words(intmax('uint32'), 'sigfig',4, 'scale','long')
ans = 'four thousand, two hundred and ninety-five million'
>> num2words(intmax('uint32'), 'sigfig',4, 'case','title', 'scale','indian')
ans = 'Four Arab, Twenty-Nine Crore, Fifty Lakh'
>> num2words(intmax('uint32'), 'order',6, 'case','upper', 'scale','yllion')
ans = 'FORTY-TWO MYLLION NINETY-FIVE HUNDRED MYRIAD'

>> num2words(1234.56, 'type','cheque', 'unit','Euro')
ans = 'one thousand, two hundred and thirty-four euro and fifty-six cents'
>> num2words(1234.56, 'type','cheque', 'unit','Pound|', 'subunit','Penny|Pence')
ans = 'one thousand, two hundred and thirty-four pounds and fifty-six pence'

>> num2words(101, 'type','money', 'unit','Dalmatian|', 'case','title')
>> num2words(1001, 'type','money', 'unit','Night|', 'case','title')
>> sprintf('%s Under the Sea',num2words(2e4, 'type','money', 'unit','League|', 'case','title'))