JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 8947280
  • Score
    100M100P100Q224844F
  • License MIT

An arbitrary-precision Decimal type for JavaScript.

Package Exports

  • decimal.js-light

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (decimal.js-light) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

decimal.js-light

The light version of decimal.js, an arbitrary-precision Decimal type for JavaScript.


[![Build Status](https://travis-ci.org/MikeMcl/decimal.js-light.svg)](https://travis-ci.org/MikeMcl/decimal.js-light)

The API is more or less a subset of the API of decimal.js.

API

Size of decimal.js-light minified: 12.7 KB.
Size of decimal.js minified: 32.1 KB.

Other differences are that this library does not include NaN, Infinity or -0 as legitimate values, or work with values in other bases.

Also, here, the Decimal.round property is just the default rounding mode for toDecimalPlaces, toExponential, toFixed, toPrecision and toSignificantDigits. It does not apply to arithmetic operations, which are simply truncated at the required precision.

Another difference is that here the naturalExponential, naturalLogarithm, logarithm, and toPower methods have by default a limited precision of around 100 digits. This limit can be increased by changing the value of LN10 (the natural logarithm of ten) in the source code, or at runtime as shown below.

// 415 digits
Decimal.set({ 
  LN10: '2.302585092994045684017991454684364207601101488628772976033327900967572609677352480235997205089598298341967784042286248633409525465082806756666287369098781689482907208325554680843799894826233198528393505308965377732628846163366222287698219886746543667474404243274365155048934314939391479619404400222105101714174800368808401264708068556774321622835522011480466371565912137345074785694768346361679210180644507064800027'
});

Quickstart

// Adjust the global configuration if required.
Decimal.set({
  precision: 20,
  rounding: Decimal.ROUND_HALF_UP,
  toExpNeg: -7,
  toExpPos: 21
});

x = new Decimal(2);
y = new Decimal(3);

// decimal.js
x.dividedBy(y).toString();                       // '0.66666666666666666667'

// decimal.js-light
x.dividedBy(y).toString();                       // '0.66666666666666666666'

x.dividedBy(y).toDecimalPlaces(19).toString();   // '0.6666666666666666667'

phi = new Decimal('1.61803398874989484820458683436563811772030917980576');

phi.toFixed(10);    // '1.6180339887'

phi.times(2).minus(1).toPower(2).plus('1e-19').equals(5);    // true

See the documentation for further information.