@rinxun/numeric-calculator 1.0.6 → 1.0.7

package/README.md

@@ -64,6 +64,7 @@ The instance supports chain operations.
 - `minus(operands: IOperand[]) => instance`
 - `times(operands: IOperand[]) => instance`
 - `divide(operands: IOperand[]) => instance`
+- `round(fractionDigits?: number) => number`
 - `toPrecision(precision?: number) => number`
 - `toFixed(fractionDigits?: number) => string`
 
@@ -141,6 +142,17 @@ const result = new NC(-1000).divide(100, '20', 2).toPrecision(); // -1000/100/20
 
 
 
+<h4>inst.round(fractionDigits?: number)</h4>
+
+``` typescript
+const result = new NC().round(3); // 0
+const result = new NC(5.255).round(2); // 5.26
+const result = new NC(7.65).times(16.5).round(2); // => 7.65 * 16.5 = 126.225 ≈ 126.23
+const result = new NC(26.05).times(16.5).round(2); // => 26.05 * 16.5 = 429.825 ≈ 429.83
+```
+
+
+
 <h4>inst.toPrecision(precision?: number)</h4>
 
 ```typescript

package/index.d.ts

@@ -81,6 +81,12 @@ declare class Calculator {
      * @param {number} num2 operand 2
      */
     private processPlus;
+    /**
+     * core processor for round
+     * @param {number} num numeric
+     * @param {number} fractionDigits default 2
+     */
+    private processRound;
     /**
      * core processor for times
      * @param {IOperand[]} operands operands
@@ -125,5 +131,11 @@ declare class Calculator {
      * @param {Array<IOperand>} operands operands
      */
     divide(...operands: Array<IOperand>): this;
+    /**
+     *
+     * @param {number} fractionDigits default to 2, should be in the range 0 - 20
+     * @returns {number} rounded result
+     */
+    round(fractionDigits?: number): number;
 }
 export default Calculator;

package/index.js

@@ -186,6 +186,17 @@ var Calculator = /** @class */ (function () {
         this.checkBoundary(amplifyingResult);
         return amplifyingResult / magnification;
     };
+    /**
+     * core processor for round
+     * @param {number} num numeric
+     * @param {number} fractionDigits default 2
+     */
+    Calculator.prototype.processRound = function (num, fractionDigits) {
+        var magnification = Math.pow(10, fractionDigits || this._fractionDigits || 2);
+        var amplifyingResult = this.processTimes(num, magnification);
+        this.checkBoundary(amplifyingResult);
+        return this.processDivide(Math.round(num), magnification);
+    };
     /**
      * core processor for times
      * @param {IOperand[]} operands operands
@@ -309,6 +320,17 @@ var Calculator = /** @class */ (function () {
         this.calculate(operands, "divide");
         return this;
     };
+    /**
+     *
+     * @param {number} fractionDigits default to 2, should be in the range 0 - 20
+     * @returns {number} rounded result
+     */
+    Calculator.prototype.round = function (fractionDigits) {
+        var magnification = Math.pow(10, fractionDigits || this._fractionDigits || 2);
+        var amplifyingResult = this.processTimes(this._VALUE || 0, magnification);
+        this.checkBoundary(amplifyingResult);
+        return this.processDivide(Math.round(amplifyingResult), magnification);
+    };
     return Calculator;
 }());
 exports.default = Calculator;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rinxun/numeric-calculator",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Calculate addition, subtraction, multiplication, division precisely, for tackling the precision issue",
   "keywords": [
     "long",