ts-time-utils 1.1.0 → 3.0.0

package/dist/esm/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/esm/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/esm/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/esm/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/dist/fiscal.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @fileoverview Fiscal year and accounting period utilities
+ * Supports configurable fiscal year start months for business calculations
+ */
+/**
+ * Fiscal year configuration
+ */
+export interface FiscalConfig {
+    /** Month when fiscal year starts (1-12, default: 1 for January) */
+    startMonth: number;
+}
+/**
+ * Get the fiscal year for a given date
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns The fiscal year number
+ * @example
+ * // Calendar year (Jan start)
+ * getFiscalYear(new Date('2024-03-15')) // 2024
+ *
+ * // April fiscal year (UK/India style)
+ * getFiscalYear(new Date('2024-03-15'), { startMonth: 4 }) // 2023
+ * getFiscalYear(new Date('2024-04-15'), { startMonth: 4 }) // 2024
+ *
+ * // July fiscal year (Australia style)
+ * getFiscalYear(new Date('2024-06-15'), { startMonth: 7 }) // 2023
+ * getFiscalYear(new Date('2024-07-15'), { startMonth: 7 }) // 2024
+ */
+export declare function getFiscalYear(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the fiscal quarter for a given date (1-4)
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns The fiscal quarter (1-4)
+ * @example
+ * // Calendar year quarters
+ * getFiscalQuarter(new Date('2024-01-15')) // 1
+ * getFiscalQuarter(new Date('2024-04-15')) // 2
+ *
+ * // April fiscal year
+ * getFiscalQuarter(new Date('2024-04-15'), { startMonth: 4 }) // 1
+ * getFiscalQuarter(new Date('2024-07-15'), { startMonth: 4 }) // 2
+ */
+export declare function getFiscalQuarter(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the start date of a fiscal year
+ * @param fiscalYear - The fiscal year
+ * @param config - Fiscal year configuration
+ * @returns Start date of the fiscal year
+ * @example
+ * getFiscalYearStart(2024) // 2024-01-01
+ * getFiscalYearStart(2024, { startMonth: 4 }) // 2024-04-01 (FY2024 starts Apr 2024)
+ * getFiscalYearStart(2024, { startMonth: 7 }) // 2024-07-01 (FY2024 starts Jul 2024)
+ */
+export declare function getFiscalYearStart(fiscalYear: number, config?: Partial<FiscalConfig>): Date;
+/**
+ * Get the end date of a fiscal year
+ * @param fiscalYear - The fiscal year
+ * @param config - Fiscal year configuration
+ * @returns End date of the fiscal year (last day, 23:59:59.999)
+ * @example
+ * getFiscalYearEnd(2024) // 2024-12-31
+ * getFiscalYearEnd(2024, { startMonth: 4 }) // 2025-03-31 (FY2024 ends Mar 2025)
+ * getFiscalYearEnd(2024, { startMonth: 7 }) // 2025-06-30 (FY2024 ends Jun 2025)
+ */
+export declare function getFiscalYearEnd(fiscalYear: number, config?: Partial<FiscalConfig>): Date;
+/**
+ * Get the start date of a fiscal quarter
+ * @param fiscalYear - The fiscal year
+ * @param quarter - The quarter (1-4)
+ * @param config - Fiscal year configuration
+ * @returns Start date of the fiscal quarter
+ * @example
+ * getFiscalQuarterStart(2024, 1) // 2024-01-01
+ * getFiscalQuarterStart(2024, 2) // 2024-04-01
+ * getFiscalQuarterStart(2024, 1, { startMonth: 4 }) // 2023-04-01
+ * getFiscalQuarterStart(2024, 2, { startMonth: 4 }) // 2023-07-01
+ */
+export declare function getFiscalQuarterStart(fiscalYear: number, quarter: number, config?: Partial<FiscalConfig>): Date;
+/**
+ * Get the end date of a fiscal quarter
+ * @param fiscalYear - The fiscal year
+ * @param quarter - The quarter (1-4)
+ * @param config - Fiscal year configuration
+ * @returns End date of the fiscal quarter (last day, 23:59:59.999)
+ * @example
+ * getFiscalQuarterEnd(2024, 1) // 2024-03-31
+ * getFiscalQuarterEnd(2024, 2) // 2024-06-30
+ * getFiscalQuarterEnd(2024, 1, { startMonth: 4 }) // 2023-06-30
+ */
+export declare function getFiscalQuarterEnd(fiscalYear: number, quarter: number, config?: Partial<FiscalConfig>): Date;
+/**
+ * Check if two dates are in the same fiscal year
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @param config - Fiscal year configuration
+ * @returns True if both dates are in the same fiscal year
+ */
+export declare function isSameFiscalYear(date1: Date, date2: Date, config?: Partial<FiscalConfig>): boolean;
+/**
+ * Check if two dates are in the same fiscal quarter
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @param config - Fiscal year configuration
+ * @returns True if both dates are in the same fiscal year and quarter
+ */
+export declare function isSameFiscalQuarter(date1: Date, date2: Date, config?: Partial<FiscalConfig>): boolean;
+/**
+ * Get the fiscal month (1-12) within the fiscal year
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns The fiscal month (1-12, where 1 is the first month of fiscal year)
+ * @example
+ * getFiscalMonth(new Date('2024-01-15')) // 1
+ * getFiscalMonth(new Date('2024-04-15'), { startMonth: 4 }) // 1
+ * getFiscalMonth(new Date('2024-03-15'), { startMonth: 4 }) // 12
+ */
+export declare function getFiscalMonth(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the number of days remaining in the fiscal year
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns Number of days remaining in the fiscal year
+ */
+export declare function getDaysRemainingInFiscalYear(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the number of days elapsed in the fiscal year
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns Number of days elapsed in the fiscal year (including the given date)
+ */
+export declare function getDaysElapsedInFiscalYear(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get fiscal year progress as a percentage
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns Percentage of fiscal year completed (0-100)
+ */
+export declare function getFiscalYearProgress(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Get the fiscal week number (1-53) within the fiscal year
+ * @param date - The date to check
+ * @param config - Fiscal year configuration
+ * @returns The fiscal week number
+ */
+export declare function getFiscalWeek(date: Date, config?: Partial<FiscalConfig>): number;
+/**
+ * Common fiscal year configurations
+ */
+export declare const FISCAL_PRESETS: {
+    /** Calendar year (January start) - Default */
+    readonly CALENDAR: FiscalConfig;
+    /** UK/India government fiscal year (April start) */
+    readonly UK_INDIA: FiscalConfig;
+    /** Australian fiscal year (July start) */
+    readonly AUSTRALIA: FiscalConfig;
+    /** US federal government fiscal year (October start) */
+    readonly US_FEDERAL: FiscalConfig;
+};
+/**
+ * Format fiscal year as string (e.g., "FY2024" or "FY2023/24")
+ * @param fiscalYear - The fiscal year
+ * @param config - Fiscal year configuration
+ * @param format - Format style: 'short' (FY2024) or 'long' (FY2023/24)
+ * @returns Formatted fiscal year string
+ */
+export declare function formatFiscalYear(fiscalYear: number, config?: Partial<FiscalConfig>, format?: 'short' | 'long'): string;
+/**
+ * Format fiscal quarter as string (e.g., "Q1 FY2024")
+ * @param fiscalYear - The fiscal year
+ * @param quarter - The quarter (1-4)
+ * @param config - Fiscal year configuration
+ * @returns Formatted fiscal quarter string
+ */
+export declare function formatFiscalQuarter(fiscalYear: number, quarter: number, config?: Partial<FiscalConfig>): string;
+/**
+ * Get fiscal period info for a date
+ * @param date - The date to analyze
+ * @param config - Fiscal year configuration
+ * @returns Object with fiscal period information
+ */
+export declare function getFiscalPeriodInfo(date: Date, config?: Partial<FiscalConfig>): {
+    fiscalYear: number;
+    fiscalQuarter: number;
+    fiscalMonth: number;
+    fiscalWeek: number;
+    daysElapsed: number;
+    daysRemaining: number;
+    progress: number;
+    quarterStart: Date;
+    quarterEnd: Date;
+    yearStart: Date;
+    yearEnd: Date;
+};
+//# sourceMappingURL=fiscal.d.ts.map

package/dist/fiscal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal.d.ts","sourceRoot":"","sources":["../src/fiscal.ts"],"names":[],"mappings":"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"}