ts-time-utils 1.1.0 → 3.0.0

package/dist/cron.js

@@ -0,0 +1,294 @@
+/**
+ * Cron expression utilities for scheduling
+ */
+/**
+ * Parse a cron expression into its parts
+ * @param expression - cron expression (5 fields: minute hour dayOfMonth month dayOfWeek)
+ */
+export function parseCronExpression(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        return null;
+    }
+    return {
+        minute: parts[0],
+        hour: parts[1],
+        dayOfMonth: parts[2],
+        month: parts[3],
+        dayOfWeek: parts[4],
+    };
+}
+/**
+ * Parse a cron field into its numeric values
+ * @param field - cron field string (e.g., "star/5", "1-5", "1,2,3", "*")
+ * @param min - minimum valid value
+ * @param max - maximum valid value
+ */
+export function parseCronField(field, min, max) {
+    const values = [];
+    // Handle wildcard
+    if (field === '*') {
+        for (let i = min; i <= max; i++) {
+            values.push(i);
+        }
+        return { type: 'all', values };
+    }
+    // Handle step values (*/n or range/n)
+    if (field.includes('/')) {
+        const [range, stepStr] = field.split('/');
+        const step = parseInt(stepStr, 10);
+        if (isNaN(step) || step <= 0)
+            return null;
+        let start = min;
+        let end = max;
+        if (range !== '*') {
+            if (range.includes('-')) {
+                const [s, e] = range.split('-').map(Number);
+                start = s;
+                end = e;
+            }
+            else {
+                start = parseInt(range, 10);
+            }
+        }
+        for (let i = start; i <= end; i += step) {
+            values.push(i);
+        }
+        return { type: 'step', values };
+    }
+    // Handle range (n-m)
+    if (field.includes('-')) {
+        const [start, end] = field.split('-').map(Number);
+        if (isNaN(start) || isNaN(end) || start > end)
+            return null;
+        for (let i = start; i <= end; i++) {
+            values.push(i);
+        }
+        return { type: 'range', values };
+    }
+    // Handle list (n,m,o)
+    if (field.includes(',')) {
+        const items = field.split(',').map(Number);
+        if (items.some(isNaN))
+            return null;
+        return { type: 'list', values: items.sort((a, b) => a - b) };
+    }
+    // Handle specific value
+    const value = parseInt(field, 10);
+    if (isNaN(value) || value < min || value > max)
+        return null;
+    return { type: 'specific', values: [value] };
+}
+/**
+ * Check if a date matches a cron expression
+ * @param date - date to check
+ * @param expression - cron expression
+ */
+export function matchesCron(date, expression) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return false;
+    const minute = parseCronField(parts.minute, 0, 59);
+    const hour = parseCronField(parts.hour, 0, 23);
+    const dayOfMonth = parseCronField(parts.dayOfMonth, 1, 31);
+    const month = parseCronField(parts.month, 1, 12);
+    const dayOfWeek = parseCronField(parts.dayOfWeek, 0, 6);
+    if (!minute || !hour || !dayOfMonth || !month || !dayOfWeek) {
+        return false;
+    }
+    return (minute.values.includes(date.getMinutes()) &&
+        hour.values.includes(date.getHours()) &&
+        dayOfMonth.values.includes(date.getDate()) &&
+        month.values.includes(date.getMonth() + 1) &&
+        dayOfWeek.values.includes(date.getDay()));
+}
+/**
+ * Get the next date that matches a cron expression
+ * @param expression - cron expression
+ * @param after - start searching after this date (default: now)
+ * @param maxIterations - maximum iterations to prevent infinite loops
+ */
+export function getNextCronDate(expression, after = new Date(), maxIterations = 525600 // Max 1 year in minutes
+) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return null;
+    const minute = parseCronField(parts.minute, 0, 59);
+    const hour = parseCronField(parts.hour, 0, 23);
+    const dayOfMonth = parseCronField(parts.dayOfMonth, 1, 31);
+    const month = parseCronField(parts.month, 1, 12);
+    const dayOfWeek = parseCronField(parts.dayOfWeek, 0, 6);
+    if (!minute || !hour || !dayOfMonth || !month || !dayOfWeek) {
+        return null;
+    }
+    const candidate = new Date(after);
+    candidate.setSeconds(0, 0);
+    candidate.setMinutes(candidate.getMinutes() + 1);
+    for (let i = 0; i < maxIterations; i++) {
+        if (minute.values.includes(candidate.getMinutes()) &&
+            hour.values.includes(candidate.getHours()) &&
+            dayOfMonth.values.includes(candidate.getDate()) &&
+            month.values.includes(candidate.getMonth() + 1) &&
+            dayOfWeek.values.includes(candidate.getDay())) {
+            return candidate;
+        }
+        candidate.setMinutes(candidate.getMinutes() + 1);
+    }
+    return null;
+}
+/**
+ * Get the N next dates that match a cron expression
+ * @param expression - cron expression
+ * @param count - number of dates to get
+ * @param after - start searching after this date
+ */
+export function getNextCronDates(expression, count, after = new Date()) {
+    const dates = [];
+    let currentAfter = after;
+    for (let i = 0; i < count; i++) {
+        const next = getNextCronDate(expression, currentAfter);
+        if (!next)
+            break;
+        dates.push(next);
+        currentAfter = next;
+    }
+    return dates;
+}
+/**
+ * Get the previous date that matched a cron expression
+ * @param expression - cron expression
+ * @param before - start searching before this date
+ * @param maxIterations - maximum iterations to prevent infinite loops
+ */
+export function getPreviousCronDate(expression, before = new Date(), maxIterations = 525600) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return null;
+    const minute = parseCronField(parts.minute, 0, 59);
+    const hour = parseCronField(parts.hour, 0, 23);
+    const dayOfMonth = parseCronField(parts.dayOfMonth, 1, 31);
+    const month = parseCronField(parts.month, 1, 12);
+    const dayOfWeek = parseCronField(parts.dayOfWeek, 0, 6);
+    if (!minute || !hour || !dayOfMonth || !month || !dayOfWeek) {
+        return null;
+    }
+    const candidate = new Date(before);
+    candidate.setSeconds(0, 0);
+    candidate.setMinutes(candidate.getMinutes() - 1);
+    for (let i = 0; i < maxIterations; i++) {
+        if (minute.values.includes(candidate.getMinutes()) &&
+            hour.values.includes(candidate.getHours()) &&
+            dayOfMonth.values.includes(candidate.getDate()) &&
+            month.values.includes(candidate.getMonth() + 1) &&
+            dayOfWeek.values.includes(candidate.getDay())) {
+            return candidate;
+        }
+        candidate.setMinutes(candidate.getMinutes() - 1);
+    }
+    return null;
+}
+/**
+ * Validate a cron expression
+ * @param expression - cron expression to validate
+ */
+export function isValidCron(expression) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return false;
+    const minute = parseCronField(parts.minute, 0, 59);
+    const hour = parseCronField(parts.hour, 0, 23);
+    const dayOfMonth = parseCronField(parts.dayOfMonth, 1, 31);
+    const month = parseCronField(parts.month, 1, 12);
+    const dayOfWeek = parseCronField(parts.dayOfWeek, 0, 6);
+    return !!(minute && hour && dayOfMonth && month && dayOfWeek);
+}
+/**
+ * Convert a cron expression to a human-readable description
+ * @param expression - cron expression
+ */
+export function describeCron(expression) {
+    const parts = parseCronExpression(expression);
+    if (!parts)
+        return null;
+    const descriptions = [];
+    // Handle common patterns
+    if (expression === '* * * * *') {
+        return 'Every minute';
+    }
+    if (expression === '0 * * * *') {
+        return 'Every hour';
+    }
+    if (expression === '0 0 * * *') {
+        return 'Every day at midnight';
+    }
+    if (expression === '0 0 * * 0') {
+        return 'Every Sunday at midnight';
+    }
+    if (expression === '0 0 1 * *') {
+        return 'First day of every month at midnight';
+    }
+    // Build description
+    const minute = parts.minute;
+    const hour = parts.hour;
+    if (minute === '0' && hour !== '*') {
+        if (hour.includes('/')) {
+            const step = hour.split('/')[1];
+            descriptions.push(`Every ${step} hours`);
+        }
+        else if (hour.includes('-')) {
+            descriptions.push(`Every hour from ${hour} at minute 0`);
+        }
+        else {
+            descriptions.push(`At ${hour}:00`);
+        }
+    }
+    else if (minute !== '*' && hour === '*') {
+        descriptions.push(`At minute ${minute} of every hour`);
+    }
+    else if (minute.includes('/')) {
+        const step = minute.split('/')[1];
+        descriptions.push(`Every ${step} minutes`);
+    }
+    if (parts.dayOfMonth !== '*') {
+        descriptions.push(`on day ${parts.dayOfMonth} of the month`);
+    }
+    if (parts.month !== '*') {
+        const monthNames = ['', 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+        const monthNum = parseInt(parts.month, 10);
+        if (!isNaN(monthNum) && monthNum >= 1 && monthNum <= 12) {
+            descriptions.push(`in ${monthNames[monthNum]}`);
+        }
+        else {
+            descriptions.push(`in month ${parts.month}`);
+        }
+    }
+    if (parts.dayOfWeek !== '*') {
+        const dayNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+        const dayNum = parseInt(parts.dayOfWeek, 10);
+        if (!isNaN(dayNum) && dayNum >= 0 && dayNum <= 6) {
+            descriptions.push(`on ${dayNames[dayNum]}`);
+        }
+        else {
+            descriptions.push(`on day of week ${parts.dayOfWeek}`);
+        }
+    }
+    return descriptions.join(' ') || expression;
+}
+/**
+ * Common cron expressions
+ */
+export const CRON_PRESETS = {
+    everyMinute: '* * * * *',
+    everyHour: '0 * * * *',
+    everyDay: '0 0 * * *',
+    everyDayAt9am: '0 9 * * *',
+    everyDayAt6pm: '0 18 * * *',
+    everyWeek: '0 0 * * 0',
+    everyMonth: '0 0 1 * *',
+    everyYear: '0 0 1 1 *',
+    weekdays: '0 0 * * 1-5',
+    weekends: '0 0 * * 0,6',
+    every5Minutes: '*/5 * * * *',
+    every15Minutes: '*/15 * * * *',
+    every30Minutes: '*/30 * * * *',
+};

package/dist/esm/calculate.d.ts

@@ -37,9 +37,14 @@ export declare function endOf(date: Date, unit: 'day' | 'week' | 'month' | 'year
  * Check if a date is between two other dates
  * @param date - date to check
  * @param start - start date (inclusive)
- * @param end - end date (inclusive)
+/**
+ * Check if a date falls between two dates
+ * @param date - date to check
+ * @param start - start date
+ * @param end - end date
+ * @param inclusive - whether boundaries are inclusive (default: true)
  */
-export declare function isBetween(date: Date, start: Date, end: Date): boolean;
+export declare function isBetween(date: Date, start: Date, end: Date, inclusive?: boolean): boolean;
 /**
  * Get the number of business days between two dates (excludes weekends)
  * @param startDate - start date

package/dist/esm/calculate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculate.d.ts","sourceRoot":"","sources":["../../src/calculate.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAExB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,IAAI,EACX,IAAI,GAAE,QAAyB,EAC/B,OAAO,GAAE,OAAc,GACtB,MAAM,CAkCR;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAgDxE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CA4BrG;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CA4BnG;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAGrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAa1E"}
+{"version":3,"file":"calculate.d.ts","sourceRoot":"","sources":["../../src/calculate.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAExB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,IAAI,EACX,IAAI,GAAE,QAAyB,EAC/B,OAAO,GAAE,OAAc,GACtB,MAAM,CAkCR;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAgDxE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CA4BrG;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CA4BnG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,GAAE,OAAc,GAAG,OAAO,CAShG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAa1E"}

package/dist/esm/calculate.js

@@ -168,11 +168,21 @@ export function endOf(date, unit) {
  * Check if a date is between two other dates
  * @param date - date to check
  * @param start - start date (inclusive)
- * @param end - end date (inclusive)
+/**
+ * Check if a date falls between two dates
+ * @param date - date to check
+ * @param start - start date
+ * @param end - end date
+ * @param inclusive - whether boundaries are inclusive (default: true)
  */
-export function isBetween(date, start, end) {
+export function isBetween(date, start, end, inclusive = true) {
     const time = date.getTime();
-    return time >= start.getTime() && time <= end.getTime();
+    const startTime = start.getTime();
+    const endTime = end.getTime();
+    if (inclusive) {
+        return time >= startTime && time <= endTime;
+    }
+    return time > startTime && time < endTime;
 }
 /**
  * Get the number of business days between two dates (excludes weekends)

package/dist/esm/calendar.d.ts

@@ -79,4 +79,107 @@ export declare function getFirstDayOfYear(year: number): Date;
  * @param year - year
  */
 export declare function getLastDayOfYear(year: number): Date;
+/**
+ * Get the nth occurrence of a day in a month (e.g., 2nd Monday)
+ * @param year - year
+ * @param month - month (0-11)
+ * @param dayOfWeek - day of week (0=Sunday, 6=Saturday)
+ * @param n - occurrence (1-5, or -1 for last)
+ */
+export declare function getNthDayOfMonth(year: number, month: number, dayOfWeek: number, n: number): Date | null;
+/**
+ * US Holiday type
+ */
+export interface USHoliday {
+    name: string;
+    date: Date;
+    type: 'federal' | 'observance';
+}
+/**
+ * Get New Year's Day
+ * @param year - year
+ */
+export declare function getNewYearsDay(year: number): Date;
+/**
+ * Get Martin Luther King Jr. Day (3rd Monday of January)
+ * @param year - year
+ */
+export declare function getMLKDay(year: number): Date | null;
+/**
+ * Get Presidents' Day (3rd Monday of February)
+ * @param year - year
+ */
+export declare function getPresidentsDay(year: number): Date | null;
+/**
+ * Get Memorial Day (last Monday of May)
+ * @param year - year
+ */
+export declare function getMemorialDay(year: number): Date | null;
+/**
+ * Get Independence Day (July 4th)
+ * @param year - year
+ */
+export declare function getIndependenceDay(year: number): Date;
+/**
+ * Get Labor Day (1st Monday of September)
+ * @param year - year
+ */
+export declare function getLaborDay(year: number): Date | null;
+/**
+ * Get Columbus Day (2nd Monday of October)
+ * @param year - year
+ */
+export declare function getColumbusDay(year: number): Date | null;
+/**
+ * Get Veterans Day (November 11th)
+ * @param year - year
+ */
+export declare function getVeteransDay(year: number): Date;
+/**
+ * Get Thanksgiving Day (4th Thursday of November)
+ * @param year - year
+ */
+export declare function getThanksgivingDay(year: number): Date | null;
+/**
+ * Get Christmas Day (December 25th)
+ * @param year - year
+ */
+export declare function getChristmasDay(year: number): Date;
+/**
+ * Get Good Friday (Friday before Easter)
+ * @param year - year
+ */
+export declare function getGoodFriday(year: number): Date;
+/**
+ * Get all US federal holidays for a year
+ * @param year - year
+ */
+export declare function getUSHolidays(year: number): USHoliday[];
+/**
+ * Check if a date is a US federal holiday
+ * @param date - date to check
+ */
+export declare function isUSHoliday(date: Date): boolean;
+/**
+ * Get the name of a US holiday for a given date
+ * @param date - date to check
+ * @returns holiday name or null if not a holiday
+ */
+export declare function getUSHolidayName(date: Date): string | null;
+/**
+ * Get the start of the week for a date (Monday)
+ * @param date - any date
+ */
+export declare function getStartOfWeek(date: Date): Date;
+/**
+ * Get the end of the week for a date (Sunday)
+ * @param date - any date
+ */
+export declare function getEndOfWeek(date: Date): Date;
+/**
+ * Get all weeks in a month as arrays of dates
+ * @param year - year
+ * @param month - month (0-11)
+ */
+export declare function getWeeksInMonth(year: number, month: number): Date[][];
 //# sourceMappingURL=calendar.d.ts.map

package/dist/esm/calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/calendar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKjD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAI/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAUD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkB5C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAKtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAEnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAElD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnD"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/calendar.ts"],"names":[],"mappings":"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"}

package/dist/esm/calendar.js

@@ -152,3 +152,227 @@ export function getFirstDayOfYear(year) {
 export function getLastDayOfYear(year) {
     return new Date(year, 11, 31);
 }
+/**
+ * Get the nth occurrence of a day in a month (e.g., 2nd Monday)
+ * @param year - year
+ * @param month - month (0-11)
+ * @param dayOfWeek - day of week (0=Sunday, 6=Saturday)
+ * @param n - occurrence (1-5, or -1 for last)
+ */
+export function getNthDayOfMonth(year, month, dayOfWeek, n) {
+    if (n === 0 || n < -1 || n > 5)
+        return null;
+    const firstDay = new Date(year, month, 1);
+    const lastDay = new Date(year, month + 1, 0);
+    if (n === -1) {
+        // Last occurrence
+        let date = lastDay.getDate();
+        while (date > 0) {
+            const d = new Date(year, month, date);
+            if (d.getDay() === dayOfWeek)
+                return d;
+            date--;
+        }
+        return null;
+    }
+    // Find nth occurrence
+    let count = 0;
+    for (let date = 1; date <= lastDay.getDate(); date++) {
+        const d = new Date(year, month, date);
+        if (d.getDay() === dayOfWeek) {
+            count++;
+            if (count === n)
+                return d;
+        }
+    }
+    return null;
+}
+/**
+ * Get New Year's Day
+ * @param year - year
+ */
+export function getNewYearsDay(year) {
+    return new Date(year, 0, 1);
+}
+/**
+ * Get Martin Luther King Jr. Day (3rd Monday of January)
+ * @param year - year
+ */
+export function getMLKDay(year) {
+    return getNthDayOfMonth(year, 0, 1, 3);
+}
+/**
+ * Get Presidents' Day (3rd Monday of February)
+ * @param year - year
+ */
+export function getPresidentsDay(year) {
+    return getNthDayOfMonth(year, 1, 1, 3);
+}
+/**
+ * Get Memorial Day (last Monday of May)
+ * @param year - year
+ */
+export function getMemorialDay(year) {
+    return getNthDayOfMonth(year, 4, 1, -1);
+}
+/**
+ * Get Independence Day (July 4th)
+ * @param year - year
+ */
+export function getIndependenceDay(year) {
+    return new Date(year, 6, 4);
+}
+/**
+ * Get Labor Day (1st Monday of September)
+ * @param year - year
+ */
+export function getLaborDay(year) {
+    return getNthDayOfMonth(year, 8, 1, 1);
+}
+/**
+ * Get Columbus Day (2nd Monday of October)
+ * @param year - year
+ */
+export function getColumbusDay(year) {
+    return getNthDayOfMonth(year, 9, 1, 2);
+}
+/**
+ * Get Veterans Day (November 11th)
+ * @param year - year
+ */
+export function getVeteransDay(year) {
+    return new Date(year, 10, 11);
+}
+/**
+ * Get Thanksgiving Day (4th Thursday of November)
+ * @param year - year
+ */
+export function getThanksgivingDay(year) {
+    return getNthDayOfMonth(year, 10, 4, 4);
+}
+/**
+ * Get Christmas Day (December 25th)
+ * @param year - year
+ */
+export function getChristmasDay(year) {
+    return new Date(year, 11, 25);
+}
+/**
+ * Get Good Friday (Friday before Easter)
+ * @param year - year
+ */
+export function getGoodFriday(year) {
+    const easter = getEaster(year);
+    const goodFriday = new Date(easter);
+    goodFriday.setDate(easter.getDate() - 2);
+    return goodFriday;
+}
+/**
+ * Get all US federal holidays for a year
+ * @param year - year
+ */
+export function getUSHolidays(year) {
+    const holidays = [];
+    holidays.push({ name: "New Year's Day", date: getNewYearsDay(year), type: 'federal' });
+    const mlk = getMLKDay(year);
+    if (mlk)
+        holidays.push({ name: "Martin Luther King Jr. Day", date: mlk, type: 'federal' });
+    const presidents = getPresidentsDay(year);
+    if (presidents)
+        holidays.push({ name: "Presidents' Day", date: presidents, type: 'federal' });
+    const memorial = getMemorialDay(year);
+    if (memorial)
+        holidays.push({ name: "Memorial Day", date: memorial, type: 'federal' });
+    holidays.push({ name: "Independence Day", date: getIndependenceDay(year), type: 'federal' });
+    const labor = getLaborDay(year);
+    if (labor)
+        holidays.push({ name: "Labor Day", date: labor, type: 'federal' });
+    const columbus = getColumbusDay(year);
+    if (columbus)
+        holidays.push({ name: "Columbus Day", date: columbus, type: 'federal' });
+    holidays.push({ name: "Veterans Day", date: getVeteransDay(year), type: 'federal' });
+    const thanksgiving = getThanksgivingDay(year);
+    if (thanksgiving)
+        holidays.push({ name: "Thanksgiving Day", date: thanksgiving, type: 'federal' });
+    holidays.push({ name: "Christmas Day", date: getChristmasDay(year), type: 'federal' });
+    return holidays.sort((a, b) => a.date.getTime() - b.date.getTime());
+}
+/**
+ * Check if a date is a US federal holiday
+ * @param date - date to check
+ */
+export function isUSHoliday(date) {
+    const holidays = getUSHolidays(date.getFullYear());
+    return holidays.some(h => h.date.getFullYear() === date.getFullYear() &&
+        h.date.getMonth() === date.getMonth() &&
+        h.date.getDate() === date.getDate());
+}
+/**
+ * Get the name of a US holiday for a given date
+ * @param date - date to check
+ * @returns holiday name or null if not a holiday
+ */
+export function getUSHolidayName(date) {
+    const holidays = getUSHolidays(date.getFullYear());
+    const holiday = holidays.find(h => h.date.getFullYear() === date.getFullYear() &&
+        h.date.getMonth() === date.getMonth() &&
+        h.date.getDate() === date.getDate());
+    return holiday ? holiday.name : null;
+}
+/**
+ * Get the start of the week for a date (Monday)
+ * @param date - any date
+ */
+export function getStartOfWeek(date) {
+    const d = new Date(date);
+    const day = d.getDay();
+    const diff = d.getDate() - day + (day === 0 ? -6 : 1); // Adjust for Monday start
+    d.setDate(diff);
+    d.setHours(0, 0, 0, 0);
+    return d;
+}
+/**
+ * Get the end of the week for a date (Sunday)
+ * @param date - any date
+ */
+export function getEndOfWeek(date) {
+    const start = getStartOfWeek(date);
+    const end = new Date(start);
+    end.setDate(start.getDate() + 6);
+    end.setHours(23, 59, 59, 999);
+    return end;
+}
+/**
+ * Get all weeks in a month as arrays of dates
+ * @param year - year
+ * @param month - month (0-11)
+ */
+export function getWeeksInMonth(year, month) {
+    const weeks = [];
+    const firstDay = new Date(year, month, 1);
+    const lastDay = new Date(year, month + 1, 0);
+    let currentWeek = [];
+    const startDayOfWeek = firstDay.getDay() || 7; // Convert Sunday from 0 to 7 for ISO
+    // Add days from previous month to fill the first week
+    for (let i = 1; i < startDayOfWeek; i++) {
+        const prevDate = new Date(year, month, 1 - (startDayOfWeek - i));
+        currentWeek.push(prevDate);
+    }
+    // Add days of the current month
+    for (let day = 1; day <= lastDay.getDate(); day++) {
+        currentWeek.push(new Date(year, month, day));
+        if (currentWeek.length === 7) {
+            weeks.push(currentWeek);
+            currentWeek = [];
+        }
+    }
+    // Add days from next month to fill the last week
+    if (currentWeek.length > 0) {
+        let nextDay = 1;
+        while (currentWeek.length < 7) {
+            currentWeek.push(new Date(year, month + 1, nextDay++));
+        }
+        weeks.push(currentWeek);
+    }
+    return weeks;
+}