@bbn/bbn 2.0.21 → 2.0.23

package/dist/date.d.ts

@@ -22,6 +22,11 @@ declare class bbnDateTool {
         weekdaysLong?: string[];
         weekdaysShort?: string[];
     }): Date;
+    /**
+     * Compare 2 dates with a given precision.
+     * @returns -1 if this < other, 0 if equal, 1 if this > other
+     */
+    static compare(date1: any, date2: any, unit?: string): -1 | 0 | 1;
     constructor(value: any, inputFormat?: null | String);
     parse(input: string, format: string): bbnDateTool;
     matchFormat(value: any, format: string): boolean;
@@ -63,11 +68,6 @@ declare class bbnDateTool {
     get S(): string;
     get WW(): string;
     get isValid(): boolean;
-    inLeapYear(): boolean;
-    daysInMonth(): number;
-    valueOf(): number;
-    add(value: number, unit?: string): bbnDateTool | null;
-    subtract(value: number, unit?: string): bbnDateTool;
     dateFromFormat(value: string, unit: string | null): Date;
     date(v?: any): string | bbnDateTool;
     datetime(v?: any): string | bbnDateTool;
@@ -77,11 +77,16 @@ declare class bbnDateTool {
     format(format?: string): string;
     unix(ms?: boolean | number): number | bbnDateTool;
     sql(noTime?: boolean): string;
+    inLeapYear(): boolean;
+    daysInMonth(): number;
+    valueOf(): number;
     /**
      * Compare this date to another date with a given precision.
      * @returns -1 if this < other, 0 if equal, 1 if this > other
      */
     compare(date: any, unit?: string): -1 | 0 | 1;
+    add(value: number, unit?: string): bbnDateTool | null;
+    subtract(value: number, unit?: string): bbnDateTool;
     isBefore(date: any, unit?: string): Boolean;
     isAfter(date: any, unit?: string): Boolean;
     isSame(date: any, unit?: string): Boolean;

package/dist/date.js

@@ -779,6 +779,44 @@ class bbnDateTool {
         }
         return date;
     }
+    /**
+     * Compare 2 dates with a given precision.
+     * @returns -1 if this < other, 0 if equal, 1 if this > other
+     */
+    static compare(date1, date2, unit = '') {
+        var _a;
+        const d1 = date1 instanceof bbnDateTool ? date1 : new bbnDateTool(date1);
+        const d2 = date2 instanceof bbnDateTool ? date2 : new bbnDateTool(date2);
+        const realUnit = unitsCorrespondence[unit] || null;
+        // If no unit or unknown unit, fall back to timestamp comparison
+        if (!realUnit) {
+            if (d1.mtst < d2.mtst) {
+                return -1;
+            }
+            if (d1.mtst > d2.mtst) {
+                return 1;
+            }
+            return 0;
+        }
+        const order = ['y', 'm', 'd', 'h', 'i', 's'];
+        // Compare step by step until the requested precision
+        for (const u of order) {
+            const key = (_a = getRow(units, un => un[0] === u)) === null || _a === void 0 ? void 0 : _a[1];
+            const a = d2[key]();
+            const b = d1[key]();
+            if (a < b) {
+                return -1;
+            }
+            if (a > b) {
+                return 1;
+            }
+            // Stop when we've reached the desired unit
+            if (u === realUnit) {
+                break;
+            }
+        }
+        return 0;
+    }
     constructor(value, inputFormat = null) {
         _bbnDateTool_value.set(this, void 0);
         _bbnDateTool_isDuration.set(this, false);
@@ -1038,52 +1076,6 @@ class bbnDateTool {
     get isValid() {
         return __classPrivateFieldGet(this, _bbnDateTool_value, "f") !== undefined;
     }
-    inLeapYear() {
-        if (this.isValid) {
-            const year = __classPrivateFieldGet(this, _bbnDateTool_value, "f").getFullYear();
-            return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
-        }
-        return false;
-    }
-    daysInMonth() {
-        if (this.isValid) {
-            switch (__classPrivateFieldGet(this, _bbnDateTool_value, "f").getMonth()) {
-                case 1:
-                    if (__classPrivateFieldGet(this, _bbnDateTool_value, "f").getFullYear() % 4 === 0) {
-                        return 29;
-                    }
-                    else {
-                        return 28;
-                    }
-                case 0:
-                case 3:
-                case 5:
-                case 8:
-                case 10:
-                    return 30;
-                default:
-                    return 31;
-            }
-        }
-    }
-    valueOf() {
-        return this.mtst;
-    }
-    add(value, unit = 'd') {
-        const date = __classPrivateFieldGet(this, _bbnDateTool_value, "f") ? new Date(__classPrivateFieldGet(this, _bbnDateTool_value, "f").getTime()) : new Date();
-        if (unitsCorrespondence[unit]) {
-            const realUnit = unitsCorrespondence[unit];
-            const suffix = realUnit === 'y' ? 'FullYear' : unitsMap[realUnit];
-            const getter = 'get' + suffix;
-            const setter = 'set' + suffix;
-            date[setter](date[getter]() + value);
-            return new bbnDateTool(date);
-        }
-        return null;
-    }
-    subtract(value, unit) {
-        return this.add(-value, unit);
-    }
     dateFromFormat(value, unit) {
         const d = new Date();
         return d;
@@ -1187,42 +1179,58 @@ class bbnDateTool {
             ? this.format('YYYY-MM-DD')
             : this.format('YYYY-MM-DD HH:II:SS');
     }
+    inLeapYear() {
+        if (this.isValid) {
+            const year = __classPrivateFieldGet(this, _bbnDateTool_value, "f").getFullYear();
+            return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
+        }
+        return false;
+    }
+    daysInMonth() {
+        if (this.isValid) {
+            switch (__classPrivateFieldGet(this, _bbnDateTool_value, "f").getMonth()) {
+                case 1:
+                    if (__classPrivateFieldGet(this, _bbnDateTool_value, "f").getFullYear() % 4 === 0) {
+                        return 29;
+                    }
+                    else {
+                        return 28;
+                    }
+                case 0:
+                case 3:
+                case 5:
+                case 8:
+                case 10:
+                    return 30;
+                default:
+                    return 31;
+            }
+        }
+    }
+    valueOf() {
+        return this.mtst;
+    }
     /**
      * Compare this date to another date with a given precision.
      * @returns -1 if this < other, 0 if equal, 1 if this > other
      */
     compare(date, unit = '') {
-        var _a;
-        const d = date instanceof bbnDateTool ? date : new bbnDateTool(date);
-        const realUnit = unitsCorrespondence[unit] || null;
-        // If no unit or unknown unit, fall back to timestamp comparison
-        if (!realUnit) {
-            if (this.mtst < d.mtst) {
-                return -1;
-            }
-            if (this.mtst > d.mtst) {
-                return 1;
-            }
-            return 0;
-        }
-        const order = ['y', 'm', 'd', 'h', 'i', 's'];
-        // Compare step by step until the requested precision
-        for (const u of order) {
-            const key = (_a = getRow(units, un => un[0] === u)) === null || _a === void 0 ? void 0 : _a[1];
-            const a = this[key]();
-            const b = d[key]();
-            if (a < b) {
-                return -1;
-            }
-            if (a > b) {
-                return 1;
-            }
-            // Stop when we've reached the desired unit
-            if (u === realUnit) {
-                break;
-            }
+        return bbnDateTool.compare(this, date, unit);
+    }
+    add(value, unit = 'd') {
+        const date = __classPrivateFieldGet(this, _bbnDateTool_value, "f") ? new Date(__classPrivateFieldGet(this, _bbnDateTool_value, "f").getTime()) : new Date();
+        if (unitsCorrespondence[unit]) {
+            const realUnit = unitsCorrespondence[unit];
+            const suffix = realUnit === 'y' ? 'FullYear' : unitsMap[realUnit];
+            const getter = 'get' + suffix;
+            const setter = 'set' + suffix;
+            date[setter](date[getter]() + value);
+            return new bbnDateTool(date);
         }
-        return 0;
+        return null;
+    }
+    subtract(value, unit) {
+        return this.add(-value, unit);
     }
     isBefore(date, unit = '') {
         return this.compare(date, unit) === -1;

package/dist/fn/object/range.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Returns a new array generated by the execution of a function for each item of the given array.
+ *
+ * The deepProp argument is the name of property which should contain a nested array on which
+ * the function should also be applied recursively.
+ *
+ * @method   map
+ * @global
+ * @example
+ * ```javascript
+ * const hours = bbn.fn.range(0, 23, 1);
+ * // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]
+ * ```
+ * @example
+ * ```javascript
+ * const minsec = bbn.fn.range(0, 59, 1).map(h => ({text: h, value: h}));
+ * // [{text: 0, value: 0}, {text: 1, value: 1}, ..., {text: 59, value: 59}]
+ * ```
+ *
+ * @memberof bbn.fn
+ * @param    {Number}   start
+ * @param    {Number}   stop
+ * @param    {Number}   step
+ * @returns  {Array}
+ */
+export default function range(start: number, stop: number, step: number): number[];

package/dist/fn/object/range.js

@@ -0,0 +1,28 @@
+/**
+ * Returns a new array generated by the execution of a function for each item of the given array.
+ *
+ * The deepProp argument is the name of property which should contain a nested array on which
+ * the function should also be applied recursively.
+ *
+ * @method   map
+ * @global
+ * @example
+ * ```javascript
+ * const hours = bbn.fn.range(0, 23, 1);
+ * // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]
+ * ```
+ * @example
+ * ```javascript
+ * const minsec = bbn.fn.range(0, 59, 1).map(h => ({text: h, value: h}));
+ * // [{text: 0, value: 0}, {text: 1, value: 1}, ..., {text: 59, value: 59}]
+ * ```
+ *
+ * @memberof bbn.fn
+ * @param    {Number}   start
+ * @param    {Number}   stop
+ * @param    {Number}   step
+ * @returns  {Array}
+ */
+export default function range(start, stop, step) {
+    return Array.from({ length: (stop - start) / step + 1 }, (value, index) => start + index * step);
+}

package/dist/fn.d.ts

@@ -197,6 +197,7 @@ import printf from './fn/string/printf.js';
 import quotes2html from './fn/string/quotes2html.js';
 import randomInt from './fn/misc/randomInt.js';
 import randomString from './fn/string/randomString.js';
+import range from './fn/object/range.js';
 import removeAccents from './fn/string/removeAccents.js';
 import removeEmpty from './fn/object/removeEmpty.js';
 import removeExtraSpaces from './fn/string/removeExtraSpaces.js';
@@ -444,6 +445,7 @@ declare const _default: {
     quotes2html: typeof quotes2html;
     randomInt: typeof randomInt;
     randomString: typeof randomString;
+    range: typeof range;
     removeAccents: typeof removeAccents;
     removeEmpty: typeof removeEmpty;
     removeExtraSpaces: typeof removeExtraSpaces;

package/dist/fn.js

@@ -197,6 +197,7 @@ import printf from './fn/string/printf.js';
 import quotes2html from './fn/string/quotes2html.js';
 import randomInt from './fn/misc/randomInt.js';
 import randomString from './fn/string/randomString.js';
+import range from './fn/object/range.js';
 import removeAccents from './fn/string/removeAccents.js';
 import removeEmpty from './fn/object/removeEmpty.js';
 import removeExtraSpaces from './fn/string/removeExtraSpaces.js';
@@ -444,6 +445,7 @@ export default {
     quotes2html,
     randomInt,
     randomString,
+    range,
     removeAccents,
     removeEmpty,
     removeExtraSpaces,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bbn/bbn",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "description": "Javascript toolkit",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",