fiscalyear

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 on this page — 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

fiscalyear on PyPI

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

Evidence: fiscalyear-0.4.0-py3-none-any.whl

Keywords: fiscal year, fiscal quarter, calendar, datetime

Tags

More Scheduling packages