Convert Words to Number

wordsToNumber

The wordsToNumber function converts an English cardinal or ordinal word string into its numeric value.

Function Signature

function wordsToNumber(word: string): number

Parameters

• word (string): The English word representation of a number to convert (cardinal or ordinal).

Return Value

• number: The numeric value of the input, or NaN if the input cannot be parsed.

Example Usage

Supported Features

• Cardinal numbers: "one", "two", ..., "one hundred", etc.
• Ordinal numbers: "first", "second", ..., "twenty-first", etc.
• Large scales: "thousand", "million", ..., "quintillion" (up to $10^20$).
• Negative numbers: prefixed with "minus" or "negative".
• Hyphenated or spaced numbers: "forty-two" or "forty two".
• "And" in numbers: "one hundred and one".
• Numeric strings: "1,234", "042", "3.14".

Aliases

The following aliases can be used for the wordsToNumber function:

• convertWordsToNumber
• wordToNumber
• convertWordToNumber

See Also

• numberToWords - For cardinal word representation of numbers.
• numberToWordsOrdinal - For ordinal word representation of numbers.