js-big-decimal

JS Big Decimal

Work with large numbers on the client side with high precision.

Operations

bigDecimal(number)

Create a new objet of type BigDecimal. Supports parameters of type number and string. If string passed cannot be parsed as a number error is thrown. It is recommended to use string as it circumvents the issue of precision with JS native float implementation and max limit for integer.

This does not support exponentiation as of yet. 12.456e3 will throw an error.

var n1 = new bigDecimal(12.6789);
var n2 = new bigDecimal("12345.6789");

getValue()

Returns the string value of the decimal.

console.log(n2.getValue()); // "12345.6789"

getPrettyValue(digits, separator)

By default this returns the number in standard number format, comma after every three digts. Both arguments, digits - the number of digits (of the integral part) to group by, and separator - the character to mark the separation. Example of this can be to format a 16 digit number as credit card.

var n3 = n2.getPrettyValue(); // n4 = "12,345.6789"

var num = new bigDecimal(1234567890123456)
var card = num.getPrettyValue(4, '-'); // cardNumber = "1234-5678-9012-3456"

round(precision)

Returns the rounded value to the specified precission (number of digits after decimal). The default is set to 0 if no argument is passed.

var n3 = n1.round(2); // n3 = "12.68"
var n4 = n2.round(); // n4 = "12346" 

add(number1, number2)

Add two numbers. Pass in negative for substraction. ensure parameters are strings.

var sum = bigDecimal.add("23.678", "67.34"); // sum = "91.018"
var diff = bigDecimal.add("67.34", "-23.678"); // diff = "43.662"