Number To Words
Contains some util methods for converting numbers into words, ordinal words and
ordinal numbers.
Install
npm install number-to-words
API
toOrdinal(number)
Converts an integer into a string with an ordinal postfix.
If number is decimal, the decimals will be removed.
var converter = require('number-to-words');
converter.toOrdinal(21);
toWords(number)
Converts an integer into words.
If number is decimal, the decimals will be removed.
var converter = require('number-to-words');
converter.toWords(13);
converter.toWords(2.9);
converter.toWords(-3);
converter.toWords(9007199254740992);
toWordsOrdinal(number)
Converts a number into ordinal words.
If number is decimal, the decimals will be removed.
var converter = require('number-to-words');
converter.toWordsOrdinal(21);
Contributions, Comments and Bugs
Contributions, comments and/or bug reports are much appreciated. Open a pull request or add comments on the
issues page. Thanks!
Upcoming v2.0
See roadmap for details.
Change Log
Version 1.2.3 (final 1.x release)
- Bug fix in
isFinite
for Phantom and IE. Thanks to @jeremiahrhall.
Version 1.2.2
- Bug fix in
toOrdinal
. Input 11, 12, and 13 now yelds the correct suffix. Thanks to @pilyugin.
Version 1.2.1
Version 1.2.0
- Bundles are now available for browsers (
./numberToWords.js
and ./numberToWords.min.js
). They export a global numberToWords
variable. - Made unit tests runnable in browser. To run the unit tests in the browser, start a local server and visit localhost/spec with a browser.
toOrdinal
, toWords
and toWordsOrdinal
now also allow string values as input (replaced Math.floor
with parseInt
).
1.1.0
- New methods
toOrdinal
and toWordsOrdinal
- Deprecated
toWords
second optional asOrdinal
parameter, use toWordsOrdinal()
-method instead toWords
now converts any decimal input to an integer (with Math.floor
)- Bug fixed returning “zeroth” instead of “zero” when converting a number word into its ordinal
1.0.1
1.0.0