
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.4 (final 1.x release)
- Bug fix in
toOrdinal. When passed -11, -12 and -13 it returned an incorrect suffix (#15). Thanks to @dmrzn.
toOrdinal and toWords now throws a more precise error when passed an unsafe number (#13). Thanks to @adrianomelo.
Version 1.2.3
- Bug fix in
isFinite for Phantom and IE (#10). Thanks to @jeremiahrhall.
Version 1.2.2
- Bug fix in
toOrdinal. Input 11, 12, and 13 now yields the correct suffix (#8). 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