Lightweight module to convert number to a pretty human readable string.
Includes:
- from-exponential - remove exponential notation
- thousands - add thousands separators
- toPrecision - adjust precision of decimal part
- stripZeros - strip unnecessary leading and trailing zeros
npm install pretty-num
import prettyNum, {PRECISION_SETTING} from 'pretty-num';
prettyNum(12.123e-10); // => '0.0000000012123'
prettyNum(0.00123456, {precision: 3}); // => '0.001'
prettyNum(0.00123456, {precision: 3, precisionSetting: PRECISION_SETTING.REDUCE_SIGNIFICANT}); // => '0.00123'
prettyNum(12345678.12345, {thousandsSeparator: ' '}); // => '12 345 678.12345'
prettyNum('00123456789.12300e-2', {precision: 3, thousandsSeparator: ' '}); // => '1 234 567.891'
Defines the thousand grouping separator character
Number of decimal digits to keep when rounding. Pass falsey value to not change precision.
How to work with precision:
1
, REDUCE
(default) - reduce precision to specified number of decimal digits, strip unnecessary ending zeros;
prettyNum(0.01023456, {precision: 3});
// => '0.01'
prettyNum(0.00001203456, {precision: 3});
// => '0'
2
, REDUCE_SIGNIFICANT
- reduce precision to specified number of significant decimal digits, strip unnecessary ending zeros. Useful when rounding small values and they should not be rounded to 0
prettyNum(0.01023456, {precision: 3, precisionSetting: PRECISION_SETTING.REDUCE_SIGNIFICANT});
// => '0.0102'
prettyNum(0.00001203456, {precision: 3, precisionSetting: PRECISION_SETTING.REDUCE_SIGNIFICANT});
// => '0.000012'
3
, FIXED
- set precision to specified number of decimal digits, pad with ending zeros if needed.
prettyNum(0.01023456, {precision: 3, precisionSetting: PRECISION_SETTING.FIXED});
// => '0.010'
prettyNum(0.00001203456, {precision: 3, precisionSetting: PRECISION_SETTING.FIXED});
// => '0.000'
4
, INCREASE
- pad with ending zeros to increase precision to specified number of decimal digits.
prettyNum(0.01, {precision: 4, precisionSetting: PRECISION_SETTING.INCREASE});
// => '0.0100'
prettyNum(12, {precision: 4, precisionSetting: PRECISION_SETTING.INCREASE});
// => '12.0000'
prettyNum(12.123456, {precision: 4, precisionSetting: PRECISION_SETTING.INCREASE});
// => '12.123456'
Specifies a rounding behavior for numerical operations capable of discarding precision. Following rounding modes are supported:
1
,UP
- Rounding mode to round away from zero.2
,DOWN
- Rounding mode to round towards zero.3
,CEIL
- Rounding mode to round towards positive infinity.4
,FLOOR
- Rounding mode to round towards negative infinity.5
,HALF_UP
- Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round up.6
,HALF_DOWN
- Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round down.7
,HALF_EVEN
- Rounding mode to round towards the "nearest neighbor" unless both neighbors are equidistant, in which case, round towards the even neighbor.
Extensive description of the modes can be found at Rounding Modes
prettyNum(123.657, {precision: 1, roundingMode: ROUNDING_MODE.DOWN}); // => "123.6"
prettyNum(123.657, {precision: 2, roundingMode: ROUNDING_MODE.CEIL}); // => "123.66"
-
js-big-decimal
:Math operations are supported,
REDUCE_SIGNIFICANT
,FIXED
andINCREASE
precisionSetting
are not supported -
big.js
:Math operations are supported, some
precisionSetting
are not supported,CEIL
,FLOOR
andHALF_DOWN
roundingMode
are not supported. -
bignumber.js
:Math operations are supported, more rounding modes are supported, some
precisionSetting
are not supported.
MIT License