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 = ;converter; // => “21st”
toWords(number)
Converts an integer into words. If number is decimal, the decimals will be removed.
var converter = ;converter; // => “thirteen” // Decimal numbers:converter; // => “two” // Negative numbers:converter; // => “minus three” // Large numbers:converter; // => “nine quadrillion, seven trillion, one hundred ninety-nine billion, two hundred fifty-four million, seven hundred forty thousand, nine hundred ninety-two”
toWordsOrdinal(number)
Converts a number into ordinal words. If number is decimal, the decimals will be removed.
var converter = ;converter; // => “twenty-first”
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
andtoWords
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
- Bower package
Version 1.2.0
- Bundles are now available for browsers (
./numberToWords.js
and./numberToWords.min.js
). They export a globalnumberToWords
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
andtoWordsOrdinal
now also allow string values as input (replacedMath.floor
withparseInt
).
1.1.0
- New methods
toOrdinal
andtoWordsOrdinal
- Deprecated
toWords
second optionalasOrdinal
parameter, usetoWordsOrdinal()
-method instead toWords
now converts any decimal input to an integer (withMath.floor
)- Bug fixed returning “zeroth” instead of “zero” when converting a number word into its ordinal
1.0.1
- Minor package tweaks
1.0.0
- Initial release