@atozinfoway/fiscal-year

Generic fiscal year utilities for Node.js/TypeScript — works for any start month/day (Jan–Dec, Apr–Mar, Jul–Jun, Oct–Sep, etc.). Optional timezone handling and quarter calculation.

Install

npm i @atozinfoway/fiscal-year

Usage

import { getFiscalYear, fiscalYearOf, getFiscalQuarter } from "@atozinfoway/fiscal-year";

// Calendar FY (Jan 1 – Dec 31)
getFiscalYear(new Date("2025-09-02"), { startMonth: 1, startDay: 1 });
// -> { startYear: 2025, endYear: 2026, label: "FY2025", labelShort: "FY2025", quarter: 3 }

// India-style FY (Apr 1 – Mar 31)
getFiscalYear(new Date("2025-09-02"), { startMonth: 4, startDay: 1 });
// -> { startYear: 2025, endYear: 2026, label: "FY2025-2026", labelShort: "FY2025-26", quarter: 2 }

// Just the quarter
getFiscalQuarter(new Date("2025-09-02"), { startMonth: 4, startDay: 1 });
// -> 2

// Minimal helper
fiscalYearOf(new Date("2025-09-02"), 4, 1);
// -> { startYear: 2025, endYear: 2026, label: "FY2025-2026", labelShort: "FY2025-26" }

API

getFiscalYear(date?, { startMonth, startDay=1, timezone? })

Returns:

• startYear — calendar year in which the FY starts
• endYear — calendar year after startYear
• label — "FY2025" for Jan–Dec, otherwise "FY2025-2026"
• labelShort — "FY2025" or "FY2025-26"
• quarter — fiscal quarter number (1–4)

fiscalYearOf(date?, startMonth=1, startDay=1)

Tiny variant (no timezone/quarter).

getFiscalQuarter(date?, { startMonth, startDay=1, timezone? })

Quarter only.

License

MIT