numeric-quantity
v2.0.1
Published
Number parser with support for mixed numbers, vulgar fractions, and Roman numerals
Downloads
121,337
Maintainers
Readme
Converts a string to a number, like an enhanced version of parseFloat
.
Features:
- In addition to plain integers and decimals,
numeric-quantity
can parse numbers with comma or underscore separators ('1,000'
or'1_000'
), mixed numbers ('1 2/3'
), vulgar fractions ('1⅖'
), and the fraction slash character ('1 2⁄3'
). - To allow and ignore trailing invalid characters à la
parseFloat
, pass{ allowTrailingInvalid: true }
as the second argument. - To parse Roman numerals like
'MCCXIV'
or'Ⅻ'
, pass{ romanNumerals: true }
as the second argument or callparseRomanNumerals
directly. - Results will be rounded to three decimal places by default. To avoid rounding, pass
{ round: false }
as the second argument. To round to a different number of decimal places, assign that number to theround
option ({ round: 5 }
will round to five decimal places). - Returns
NaN
if the provided string does not resemble a number.
For the inverse operation—converting a number to an imperial measurement—check out format-quantity.
For a more complete solution to parsing recipe ingredients, try parse-ingredient.
Usage
Installed
import { numericQuantity } from 'numeric-quantity';
console.log(numericQuantity('1 1/2')); // 1.5
console.log(numericQuantity('2 2/3')); // 2.667
CDN
As an ES module:
<script type="module">
import { numericQuantity } from 'https://cdn.jsdelivr.net/npm/numeric-quantity/+esm';
console.log(numericQuantity('10½')); // 10.5
</script>
As UMD (all exports are properties of the global object NumericQuantity
):
<script src="https://unpkg.com/numeric-quantity"></script>
<script>
console.log(NumericQuantity.numericQuantity('xii', { romanNumerals: true })); // 12
</script>