@bbn/bbn 1.0.459 → 1.0.461

package/dist/date.d.ts

@@ -43,7 +43,18 @@ declare class bbnDateTool {
     guessUnit(valueInMs: number): string | null;
     diff(date: any, unit?: string, abs?: boolean): number;
     calendar(format: string): string;
-    getWeekDay(n: 0 | 1 | 2 | 3 | 4 | 5 | 6, mode?: 'long' | 'short' | 'narrow', locale?: string): String;
+    getWeekDay(n: 0 | 1 | 2 | 3 | 4 | 5 | 6, mode?: string, locale?: string): any;
+    copy(): Date;
+    /**
+     * Returns a NEW bbnDateTool at the start of the given unit.
+     * Units: year, month, week, day, hour, minute, second
+     */
+    startOf(unit?: string): bbnDateTool;
+    /**
+     * Returns a NEW bbnDateTool at the end of the given unit.
+     * Units: year, month, week, day, hour, minute, second
+     */
+    endOf(unit?: string): bbnDateTool;
     get daysInMonth(): number;
 }
 declare function generatorFunction(value: any, inputFormat?: null | String): bbnDateTool;

package/dist/date.js

@@ -496,10 +496,129 @@ class bbnDateTool {
         return str;
     }
     getWeekDay(n, mode = 'long', locale) {
+        if (!mode) {
+            const letter = this.getWeekDay(n, 'narrow', locale);
+            const abbr = this.getWeekDay(n, 'short', locale);
+            const full = this.getWeekDay(n, 'long', locale);
+            return {
+                letter,
+                abbr,
+                full,
+                long: full,
+                short: abbr,
+                narrow: letter
+            };
+        }
+        let m;
+        if (mode === 'letter') {
+            m = 'narrow';
+        }
+        else if (mode === 'abbr') {
+            m = 'short';
+        }
+        else if (mode === 'full') {
+            m = 'long';
+        }
+        else if (!['long', 'short', 'narrow'].includes(mode)) {
+            throw new Error('Invalid mode for getWeekDay: ' + mode + '. Allowed values are "long", "short", "narrow", "letter", "abbr", "full".');
+        }
+        else {
+            m = mode;
+        }
         // Create a date with the right weekday
         // 2023-01-01 was a Sunday → base for offset
         const base = new Date(2023, 0, 1 + n);
-        return base.toLocaleDateString([bbn.env.lang, ...navigator.languages], { weekday: mode });
+        return base.toLocaleDateString([locale || bbn.env.lang, ...navigator.languages], { weekday: m });
+    }
+    copy() {
+        return new Date(__classPrivateFieldGet(this, _bbnDateTool_value, "f").getTime());
+    }
+    /**
+     * Returns a NEW bbnDateTool at the start of the given unit.
+     * Units: year, month, week, day, hour, minute, second
+     */
+    startOf(unit = "d") {
+        const u = unitsCorrespondence[unit];
+        if (!u) {
+            throw new Error('Invalid unit for startOf: ' + unit);
+        }
+        let d;
+        switch (u) {
+            case "y":
+                d = new Date(this.year, 0, 1, 0, 0, 0, 0);
+                break;
+            case "m":
+                d = new Date(this.year, this.month - 1, 1, 0, 0, 0, 0);
+                break;
+            case "w": {
+                // Week starting Monday:
+                // JS getDay(): 0 (Sun) .. 6 (Sat)
+                const current = new Date(this.year, this.month - 1, this.day, this.hours, this.minutes, this.seconds, 0);
+                const wd = current.getDay(); // 0..6
+                const diffToMonday = (wd + 6) % 7; // 0 for Monday, 6 for Sunday
+                d = new Date(current.getFullYear(), current.getMonth(), current.getDate() - diffToMonday, 0, 0, 0, 0);
+                break;
+            }
+            case "d":
+                d = new Date(this.year, this.month - 1, this.day, 0, 0, 0, 0);
+                break;
+            case "h":
+                d = new Date(this.year, this.month - 1, this.day, this.hours, 0, 0, 0);
+                break;
+            case "i":
+                d = new Date(this.year, this.month - 1, this.day, this.hours, this.minutes, 0, 0);
+                break;
+            case "s":
+                d = new Date(this.year, this.month - 1, this.day, this.hours, this.minutes, this.seconds, 0);
+                break;
+            default:
+                throw new Error('Invalid unit for startOf: ' + unit);
+        }
+        return new bbnDateTool(d);
+    }
+    /**
+     * Returns a NEW bbnDateTool at the end of the given unit.
+     * Units: year, month, week, day, hour, minute, second
+     */
+    endOf(unit = "d") {
+        const u = unitsCorrespondence[unit];
+        if (!u) {
+            throw new Error('Invalid unit for endOf: ' + unit);
+        }
+        let d;
+        switch (u) {
+            case "y":
+                // Dec 31, 23:59:59.999
+                d = new Date(this.year, 11, 31, 23, 59, 59, 999);
+                break;
+            case "m":
+                // Day 0 of next month = last day of this month
+                d = new Date(this.year, this.month, 0, 23, 59, 59, 999);
+                break;
+            case "w": {
+                // End of week (starting Monday) = startOf('week') + 6 days, at 23:59:59.999
+                const start = this.startOf("w");
+                const base = new Date(start.year, start.month - 1, start.day, 23, 59, 59, 999);
+                base.setDate(base.getDate() + 6);
+                d = base;
+                break;
+            }
+            case "day":
+                d = new Date(this.year, this.month - 1, this.day, 23, 59, 59, 999);
+                break;
+            case "hour":
+                d = new Date(this.year, this.month - 1, this.day, this.hours, 59, 59, 999);
+                break;
+            case "minute":
+                d = new Date(this.year, this.month - 1, this.day, this.hours, this.minutes, 59, 999);
+                break;
+            case "second":
+                d = new Date(this.year, this.month - 1, this.day, this.hours, this.minutes, this.seconds, 999);
+                break;
+            default:
+                d = new Date(this.mtst);
+        }
+        return new bbnDateTool(d);
     }
     get daysInMonth() {
         if (this.isValid && !__classPrivateFieldGet(this, _bbnDateTool_daysInMonth, "f")) {

package/package.json

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