Merge branch 'feature/string-builder'

Author: jamesmcroft

MADE.Data.Converters/src/math/index.ts

@@ -5,4 +5,35 @@
  */
 export function toRadians(degrees: number): number {
     return degrees * (Math.PI / 180);
-}
+}
+
+/**
+ * Rounds a value, towards zero, if the remainder of dividing number by multiple is greater than or equal to half the value of multiple.
+ * @param {number} number - The value to round.
+ * @param {number} multiple - The multiple to which you want to round number.
+ * @return {number} The number rounded to the desired multiple.
+ */
+export function mRound(number: number, multiple: number): number {
+    if (isNaN(multiple)) {
+        return 0;
+    }
+
+    multiple = Number(multiple);
+    var result = number % multiple;
+    if (result < 0) {
+        return -mRound(-number, -multiple);
+    }
+
+    result = Number((number - result).toFixed(0));
+    var compare = (multiple / 2) <= Math.abs(number - result);
+    if (compare) {
+        if (result < 0) {
+            result -= multiple;
+        } else {
+            result += multiple;
+        }
+    }
+
+
+    return result;
+}

MADE.Data.Converters/tests/math/mRound.spec.ts

@@ -0,0 +1,14 @@
+import { mRound } from '../../src'
+
+describe("when rounding to the nearest multiple", () => {
+    test.each([
+        [10, 3, 9],
+        [-10, -3, -9],
+        [1.3, 0.2, 1.2],
+    ])(
+        "should round to the nearest multiple of the given number",
+        (value, multiple, expected) => {
+            expect(mRound(value, multiple)).toBe(expected)
+        }
+    )
+});