ts-time-utils 1.1.0 → 2.0.0

package/dist/workingHours.d.ts

@@ -13,4 +13,74 @@ export declare function nextWorkingTime(date: Date, config?: WorkingHoursConfig)
 export declare function workingTimeBetween(start: Date, end: Date, config?: WorkingHoursConfig): number;
 /** Advance by working hours amount (simple iterative approach) */
 export declare function addWorkingHours(start: Date, hours: number, config?: WorkingHoursConfig): Date;
+/**
+ * Add working days to a date
+ * @param start - start date
+ * @param days - number of working days to add
+ * @param config - working hours configuration
+ */
+export declare function addWorkingDays(start: Date, days: number, config?: WorkingHoursConfig): Date;
+/**
+ * Subtract working days from a date
+ * @param start - start date
+ * @param days - number of working days to subtract
+ * @param config - working hours configuration
+ */
+export declare function subtractWorkingDays(start: Date, days: number, config?: WorkingHoursConfig): Date;
+/**
+ * Get the next working day from a given date
+ * @param date - start date
+ * @param config - working hours configuration
+ */
+export declare function getNextWorkingDay(date: Date, config?: WorkingHoursConfig): Date;
+/**
+ * Get the previous working day from a given date
+ * @param date - start date
+ * @param config - working hours configuration
+ */
+export declare function getPreviousWorkingDay(date: Date, config?: WorkingHoursConfig): Date;
+/**
+ * Get the number of working days in a month
+ * @param year - year
+ * @param month - month (0-11)
+ * @param config - working hours configuration
+ */
+export declare function getWorkingDaysInMonth(year: number, month: number, config?: WorkingHoursConfig): number;
+/**
+ * Get all working days in a month as an array of dates
+ * @param year - year
+ * @param month - month (0-11)
+ * @param config - working hours configuration
+ */
+export declare function getWorkingDaysInMonthArray(year: number, month: number, config?: WorkingHoursConfig): Date[];
+/**
+ * Get working days between two dates (inclusive)
+ * @param start - start date
+ * @param end - end date
+ * @param config - working hours configuration
+ */
+export declare function workingDaysBetween(start: Date, end: Date, config?: WorkingHoursConfig): number;
+/**
+ * Check if a date is during work break
+ * @param date - date to check
+ * @param config - working hours configuration
+ */
+export declare function isBreakTime(date: Date, config?: WorkingHoursConfig): boolean;
+/**
+ * Get the start of the work day for a given date
+ * @param date - date to get work start for
+ * @param config - working hours configuration
+ */
+export declare function getWorkDayStart(date: Date, config?: WorkingHoursConfig): Date;
+/**
+ * Get the end of the work day for a given date
+ * @param date - date to get work end for
+ * @param config - working hours configuration
+ */
+export declare function getWorkDayEnd(date: Date, config?: WorkingHoursConfig): Date;
+/**
+ * Get the total working hours per day (excluding breaks)
+ * @param config - working hours configuration
+ */
+export declare function getWorkingHoursPerDay(config?: WorkingHoursConfig): number;
 //# sourceMappingURL=workingHours.d.ts.map

package/dist/workingHours.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workingHours.d.ts","sourceRoot":"","sources":["../src/workingHours.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,qBAAqB,EAAE,kBAInC,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,OAAO,CAEpG;AAOD,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,OAAO,CAUrG;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAMpG;AAYD,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,MAAM,CA+BrH;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAcpH"}
+{"version":3,"file":"workingHours.d.ts","sourceRoot":"","sources":["../src/workingHours.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,qBAAqB,EAAE,kBAInC,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,OAAO,CAEpG;AAOD,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,OAAO,CAUrG;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAMpG;AAYD,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,MAAM,CA+BrH;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAcpH;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAelH;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAEvH;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAStG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAS1G;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,kBAA0C,GAAG,MAAM,CAY7H;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,EAAE,CAYlI;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,MAAM,CAkBrH;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,OAAO,CASnG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAIpG;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,kBAA0C,GAAG,IAAI,CAIlG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,kBAA0C,GAAG,MAAM,CAUhG"}

package/dist/workingHours.js

@@ -107,3 +107,164 @@ export function addWorkingHours(start, hours, config = DEFAULT_WORKING_HOURS) {
     }
     return cursor;
 }
+/**
+ * Add working days to a date
+ * @param start - start date
+ * @param days - number of working days to add
+ * @param config - working hours configuration
+ */
+export function addWorkingDays(start, days, config = DEFAULT_WORKING_HOURS) {
+    if (days === 0)
+        return new Date(start);
+    const result = new Date(start);
+    const direction = days > 0 ? 1 : -1;
+    let remaining = Math.abs(days);
+    while (remaining > 0) {
+        result.setDate(result.getDate() + direction);
+        if (isWorkingDay(result, config)) {
+            remaining--;
+        }
+    }
+    return result;
+}
+/**
+ * Subtract working days from a date
+ * @param start - start date
+ * @param days - number of working days to subtract
+ * @param config - working hours configuration
+ */
+export function subtractWorkingDays(start, days, config = DEFAULT_WORKING_HOURS) {
+    return addWorkingDays(start, -days, config);
+}
+/**
+ * Get the next working day from a given date
+ * @param date - start date
+ * @param config - working hours configuration
+ */
+export function getNextWorkingDay(date, config = DEFAULT_WORKING_HOURS) {
+    const result = new Date(date);
+    result.setDate(result.getDate() + 1);
+    while (!isWorkingDay(result, config)) {
+        result.setDate(result.getDate() + 1);
+    }
+    return result;
+}
+/**
+ * Get the previous working day from a given date
+ * @param date - start date
+ * @param config - working hours configuration
+ */
+export function getPreviousWorkingDay(date, config = DEFAULT_WORKING_HOURS) {
+    const result = new Date(date);
+    result.setDate(result.getDate() - 1);
+    while (!isWorkingDay(result, config)) {
+        result.setDate(result.getDate() - 1);
+    }
+    return result;
+}
+/**
+ * Get the number of working days in a month
+ * @param year - year
+ * @param month - month (0-11)
+ * @param config - working hours configuration
+ */
+export function getWorkingDaysInMonth(year, month, config = DEFAULT_WORKING_HOURS) {
+    const daysInMonth = new Date(year, month + 1, 0).getDate();
+    let count = 0;
+    for (let day = 1; day <= daysInMonth; day++) {
+        const date = new Date(year, month, day);
+        if (isWorkingDay(date, config)) {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Get all working days in a month as an array of dates
+ * @param year - year
+ * @param month - month (0-11)
+ * @param config - working hours configuration
+ */
+export function getWorkingDaysInMonthArray(year, month, config = DEFAULT_WORKING_HOURS) {
+    const daysInMonth = new Date(year, month + 1, 0).getDate();
+    const workingDays = [];
+    for (let day = 1; day <= daysInMonth; day++) {
+        const date = new Date(year, month, day);
+        if (isWorkingDay(date, config)) {
+            workingDays.push(date);
+        }
+    }
+    return workingDays;
+}
+/**
+ * Get working days between two dates (inclusive)
+ * @param start - start date
+ * @param end - end date
+ * @param config - working hours configuration
+ */
+export function workingDaysBetween(start, end, config = DEFAULT_WORKING_HOURS) {
+    if (end < start)
+        return 0;
+    let count = 0;
+    const current = new Date(start);
+    current.setHours(0, 0, 0, 0);
+    const endDate = new Date(end);
+    endDate.setHours(0, 0, 0, 0);
+    while (current <= endDate) {
+        if (isWorkingDay(current, config)) {
+            count++;
+        }
+        current.setDate(current.getDate() + 1);
+    }
+    return count;
+}
+/**
+ * Check if a date is during work break
+ * @param date - date to check
+ * @param config - working hours configuration
+ */
+export function isBreakTime(date, config = DEFAULT_WORKING_HOURS) {
+    if (!isWorkingDay(date, config))
+        return false;
+    if (!config.breaks || config.breaks.length === 0)
+        return false;
+    const h = toHourFraction(date);
+    for (const b of config.breaks) {
+        if (h >= b.start && h < b.end)
+            return true;
+    }
+    return false;
+}
+/**
+ * Get the start of the work day for a given date
+ * @param date - date to get work start for
+ * @param config - working hours configuration
+ */
+export function getWorkDayStart(date, config = DEFAULT_WORKING_HOURS) {
+    const result = new Date(date);
+    result.setHours(config.hours.start, 0, 0, 0);
+    return result;
+}
+/**
+ * Get the end of the work day for a given date
+ * @param date - date to get work end for
+ * @param config - working hours configuration
+ */
+export function getWorkDayEnd(date, config = DEFAULT_WORKING_HOURS) {
+    const result = new Date(date);
+    result.setHours(config.hours.end, 0, 0, 0);
+    return result;
+}
+/**
+ * Get the total working hours per day (excluding breaks)
+ * @param config - working hours configuration
+ */
+export function getWorkingHoursPerDay(config = DEFAULT_WORKING_HOURS) {
+    let hours = config.hours.end - config.hours.start;
+    if (config.breaks) {
+        for (const b of config.breaks) {
+            hours -= (b.end - b.start);
+        }
+    }
+    return hours;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-time-utils",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "A comprehensive TypeScript utility library for time, dates, durations, and calendar operations with full tree-shaking support",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
@@ -106,20 +106,31 @@
       "import": "./dist/esm/naturalLanguage.js",
       "require": "./dist/naturalLanguage.js",
       "types": "./dist/naturalLanguage.d.ts"
+    },
+    "./cron": {
+      "import": "./dist/esm/cron.js",
+      "require": "./dist/cron.js",
+      "types": "./dist/cron.d.ts"
+    },
+    "./fiscal": {
+      "import": "./dist/esm/fiscal.js",
+      "require": "./dist/fiscal.js",
+      "types": "./dist/fiscal.d.ts"
+    },
+    "./compare": {
+      "import": "./dist/esm/compare.js",
+      "require": "./dist/compare.js",
+      "types": "./dist/compare.d.ts"
+    },
+    "./iterate": {
+      "import": "./dist/esm/iterate.js",
+      "require": "./dist/iterate.js",
+      "types": "./dist/iterate.d.ts"
     }
   },
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "npm run build:cjs && npm run build:esm",
-    "build:cjs": "tsc -p tsconfig.json",
-    "build:esm": "tsc -p tsconfig.esm.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src --ext .ts",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "time",
     "date",
@@ -162,5 +173,13 @@
   "homepage": "https://github.com/hatefrad/ts-time-utils#readme",
   "bugs": {
     "url": "https://github.com/hatefrad/ts-time-utils/issues"
+  },
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm",
+    "build:cjs": "tsc -p tsconfig.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts"
   }
-}
+}