Fiscal

Fiscal year utilities with configurable start month

Edit and run examples against `ts-time-utils@4.4.1` in your browser.

Fiscal Year Calculations

Work with fiscal years and quarters

index.ts

import { getFiscalYear, getFiscalQuarter, getFiscalPeriodInfo, FISCAL_PRESETS } from 'ts-time-utils/fiscal';

const date = new Date('2025-09-14');

// Calendar year fiscal (Jan start)
console.log(getFiscalYear(date, FISCAL_PRESETS.CALENDAR)); // 2025

// UK/India fiscal (April start)
console.log(getFiscalYear(date, FISCAL_PRESETS.UK_INDIA)); // 2025

// Australia fiscal (July start)
console.log(getFiscalYear(date, FISCAL_PRESETS.AUSTRALIA)); // 2026

// US Federal (October start)
console.log(getFiscalYear(date, FISCAL_PRESETS.US_FEDERAL)); // 2025

// Get fiscal quarter
console.log(getFiscalQuarter(date, { startMonth: 4 })); // Q2 for UK

// Detailed fiscal period info
const info = getFiscalPeriodInfo(date, { startMonth: 4 });
console.log(info);
// { fiscalYear, quarter, month, daysElapsed, daysRemaining, progress }

Console

Press Run to execute the example.