@bbn/bbn 1.0.460 → 1.0.461

package/dist/date.d.ts

@@ -44,6 +44,17 @@ declare class bbnDateTool {
     diff(date: any, unit?: string, abs?: boolean): number;
     calendar(format: 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

@@ -530,6 +530,96 @@ class bbnDateTool {
         const base = new Date(2023, 0, 1 + n);
         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")) {
             switch (__classPrivateFieldGet(this, _bbnDateTool_value, "f").getMonth()) {

package/package.json

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