---
id: fiscalyear
version: "0.4.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# fiscalyear — Utilities for managing the fiscal calendar

License: permissive · Maintenance: dormant · Downloads: 370.5K/mo

## What it is and what it does

fiscalyear is a lightweight Python module that maps dates and datetimes onto fiscal calendar periods—fiscal years, quarters, months, and days—rather than calendar years. It provides FiscalYear, FiscalQuarter, FiscalMonth, FiscalDay, and FiscalDateTime classes that mirror Python's built-in datetime API but work with fiscal periods instead. Each fiscal period object knows its start and end times, can check containment, and can navigate to adjacent periods.

The package is designed for accounting, financial reporting, and scheduling workflows where fiscal periods matter more than calendar months. It has no external dependencies and requires Python 3.6 or later. The module is stable but dormant—the last release was in February 2022, though the repository remains active with occasional commits.

Use it for:

- Generate fiscal year reports or dashboards that group transactions by fiscal quarter or month rather than calendar periods
- Validate that a given date falls within a specific fiscal period for accounting or compliance workflows
- Build scheduling systems that track work or milestones by fiscal day or quarter instead of calendar dates
- Convert calendar dates to fiscal identifiers for financial data pipelines or APIs

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides fiscal year, quarter, month, and day abstractions that extend Python's datetime and calendar modules to work with fiscal calendars instead of calendar years.

Yes, if you work with fiscal calendars in accounting, finance, or scheduling. The package is stable, dependency-free, and solves a narrow but real problem. The dormant maintenance status is not a concern for a mature, feature-complete utility with no external dependencies and no known vulnerabilities. Install it if fiscal periods are part of your domain; skip it if you only work with calendar years.

## Install

pip install fiscalyear
uv add fiscalyear
poetry add fiscalyear

## Installing fiscalyear

Before you install: Installation is straightforward with no runtime dependencies. The package is dormant (last release February 2022, last commit November 2024) but remains functional for its narrow use case.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install fiscalyear

from fiscalyear import FiscalYear, FiscalDateTime
a = FiscalYear(2017)
print(a.start)
e = FiscalDateTime.now()
print(e.fiscal_year)

Verify before relying:

- Whether the package handles non-standard fiscal year start dates or only US federal fiscal years
- Current test coverage and whether dormant status indicates unaddressed edge cases or stable, complete functionality

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 370.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

fiscal year calendar, fiscal quarter tracking, fiscal month datetime, accounting period utilities, fiscal day calculation, fiscal calendar management, fiscal datetime objects, fiscal-calendar, accounting, datetime-extension

[View on SkillFed](https://skillfed.io/packages/fiscalyear) · [View on PyPI](https://pypi.org/project/fiscalyear/)