ts-time-utils 1.1.0 → 3.0.0

package/dist/validate.js

@@ -106,3 +106,95 @@ export function isValidISOString(dateString) {
     const isoRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z?$/;
     return isoRegex.test(dateString) && isValidDate(dateString);
 }
+/**
+ * Check if two dates are in the same week (ISO week, Monday-Sunday)
+ * @param date1 - first date
+ * @param date2 - second date
+ */
+export function isSameWeek(date1, date2) {
+    const getWeekStart = (d) => {
+        const date = new Date(d);
+        const day = date.getDay();
+        const diff = date.getDate() - day + (day === 0 ? -6 : 1); // Adjust for Monday start
+        date.setDate(diff);
+        date.setHours(0, 0, 0, 0);
+        return date;
+    };
+    return getWeekStart(date1).getTime() === getWeekStart(date2).getTime();
+}
+/**
+ * Check if two dates are in the same month
+ * @param date1 - first date
+ * @param date2 - second date
+ */
+export function isSameMonth(date1, date2) {
+    return (date1.getMonth() === date2.getMonth() &&
+        date1.getFullYear() === date2.getFullYear());
+}
+/**
+ * Check if two dates are in the same year
+ * @param date1 - first date
+ * @param date2 - second date
+ */
+export function isSameYear(date1, date2) {
+    return date1.getFullYear() === date2.getFullYear();
+}
+/**
+ * Check if a date is in the current week
+ * @param date - date to check
+ */
+export function isThisWeek(date) {
+    return isSameWeek(date, new Date());
+}
+/**
+ * Check if a date is in the current month
+ * @param date - date to check
+ */
+export function isThisMonth(date) {
+    return isSameMonth(date, new Date());
+}
+/**
+ * Check if a date is in the current year
+ * @param date - date to check
+ */
+export function isThisYear(date) {
+    return isSameYear(date, new Date());
+}
+/**
+ * Check if a date is a business day (weekday, optionally excluding holidays)
+ * @param date - date to check
+ * @param holidays - optional array of holiday dates to exclude
+ */
+export function isBusinessDay(date, holidays = []) {
+    if (isWeekend(date))
+        return false;
+    return !holidays.some(holiday => isSameDay(date, holiday));
+}
+/**
+ * Check if a date is in the last N days (including today)
+ * @param date - date to check
+ * @param n - number of days
+ */
+export function isInLastNDays(date, n) {
+    const now = new Date();
+    const nDaysAgo = new Date(now);
+    nDaysAgo.setDate(nDaysAgo.getDate() - n);
+    nDaysAgo.setHours(0, 0, 0, 0);
+    const endOfToday = new Date(now);
+    endOfToday.setHours(23, 59, 59, 999);
+    return date >= nDaysAgo && date <= endOfToday;
+}
+/**
+ * Check if a date is in the next N days (including today)
+ * @param date - date to check
+ * @param n - number of days
+ */
+export function isInNextNDays(date, n) {
+    const now = new Date();
+    const startOfToday = new Date(now);
+    startOfToday.setHours(0, 0, 0, 0);
+    const nDaysFromNow = new Date(now);
+    nDaysFromNow.setDate(nDaysFromNow.getDate() + n);
+    nDaysFromNow.setHours(23, 59, 59, 999);
+    return date >= startOfToday && date <= nDaysFromNow;
+}

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": "3.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,6 +106,41 @@
       "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"
+    },
+    "./holidays": {
+      "import": "./dist/esm/holidays.js",
+      "require": "./dist/holidays.js",
+      "types": "./dist/holidays.d.ts"
+    },
+    "./chain": {
+      "import": "./dist/esm/chain.js",
+      "require": "./dist/chain.js",
+      "types": "./dist/chain.d.ts"
+    },
+    "./plugins": {
+      "import": "./dist/esm/plugins.js",
+      "require": "./dist/plugins.js",
+      "types": "./dist/plugins.d.ts"
     }
   },
   "files": [
@@ -118,6 +153,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src --ext .ts",
+    "size": "size-limit",
+    "size:check": "size-limit --json > docs/bundle-sizes.json",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -152,6 +189,8 @@
   "author": "",
   "license": "MIT",
   "devDependencies": {
+    "@size-limit/file": "^12.0.0",
+    "size-limit": "^12.0.0",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   },