nmbr
Isomorphic JavaScript numbers parser and formatter
Requirements
Installation
npm install nmbr --save
// Standard HTML import
// JS module;
API
Formatter
Converts the number to a string by specified options.
formatNumber
This method takes 2 arguments:
number
- any JS numberoptions
:
{
fractionSize?: number;
roundSize?: number;
minFractionSize?: number;
separateThousands?: boolean;
thousandDelimiter?: string;
fractionDelimiter?: string;
preset?: string;
}
Example:
; // '2.453,43'const result = ;
More cases you may find in my test cases
Formatting presets
You may define your own set of rules for formatting:
; ; // '120.009,1'const result = ;
Parser
parseNumber
Parses a number from input string:
; // 1234; // 1234.56; // 1234.56; // 1234567
You may omit delimiter options if you parse only fractional numbers:
; ; // 0.02; // 0.1; // 1; // -1.2; // -1; // 1.1; // -1.2; // -112.78; // -113.79
Shortener
shortNumber
Converts long numbers to short ones:
; ; // 5.4k; // 1.2M; // The size is 1.2(Mb)
This method takes 2 arguments:
value
- number or string:2.13
or'2.13'
options
:
{
fractionSize?: number;
template?: string;
maxUnit?: NumberShortenerUnitName;
minUnit?: NumberShortenerUnitName;
}
// NumberShortenerUnitName = 'Y'|'Z'|'E'|'P'|'T'|'G'|'M'|'k'|'h'|'da'|'d'|'c'|'m'|'µ'|'n'|'p'|'f'|'a'|'z'|'y'