datetime-quarter
Simple and lightweight quarter support for python datetime
Decision gist · record as of 2026-08-14
Yes, if you need lightweight quarter arithmetic and your project is stable. The package is simple, dependency-free, and works for its stated purpose. However, the abandoned status means no future bug fixes or Python version support—evaluate whether you can maintain a fork or accept the risk of eventual incompatibility. For new projects with long-term support requirements, consider whether a more actively maintained alternative or a custom implementation would be safer.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction—pure Python, no runtime dependencies.
- However, the package is abandoned; last release was 2020-02-09 and no updates have been made since.
- Use only if the existing feature set meets your needs and you're comfortable maintaining a fork if issues arise.
License · maintenance · safety
permissive license (permissive) — MIT license (permissive); you may use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
last release 2020-02-09 (2378 days) · last repo commit 2020-02-09 · 12 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 149,317 downloads/mo, #10,995 on PyPI
Alternatives
Verify before relying
pip install datetime-quarter
from datetime import date
from datetime_quarter import DateQuarter
q = DateQuarter(2019, 4)
print(q) # 2019 4Q
print(q.start_date())
print(q.end_date())- Whether the package works correctly with modern Python versions given its abandoned status and lack of recent testing.
- Whether quarter numbering follows ISO 8601 or a different standard, and whether it handles fiscal years with non-standard quarter boundaries.
- The correct import path for the DateQuarter class (fact sheet shows usage but not the exact module name).
What it is and what it does
datetime-quarter wraps Python's standard datetime.date with a DateQuarter class that treats fiscal or calendar quarters as discrete, comparable units. Instead of working with individual dates or month ranges, you create a quarter object (e.g., DateQuarter(2019, 4) for Q4 2019), then add, subtract, compare, or iterate over it. The package handles quarter arithmetic, distance calculations between quarters, membership tests, and range iteration.
The package has no runtime dependencies and installs as pure Python, making it lightweight. However, it has been abandoned since its initial release in 2020 with no subsequent updates, bug fixes, or maintenance. It remains functional for straightforward quarter operations but carries the risk of incompatibility with future Python versions or edge cases that may not have been discovered or addressed.
Use it for
- Build financial reporting systems that organize data and metrics by fiscal quarter rather than by month or year.
- Generate quarterly date ranges for filtering historical data or defining reporting periods in analytics pipelines.
- Perform quarter-over-quarter comparisons by adding or subtracting quarters to shift analysis windows forward or backward.
- Validate whether a given date falls within a specific quarter for business logic or data validation rules.
- Iterate over all quarters within a date range to generate quarterly summaries or reports.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need lightweight quarter arithmetic and your project is stable.
The package is simple, dependency-free, and works for its stated purpose. However, the abandoned status means no future bug fixes or Python version support—evaluate whether you can maintain a fork or accept the risk of eventual incompatibility. For new projects with long-term support requirements, consider whether a more actively maintained alternative or a custom implementation would be safer.
Install
datetime-quarter on PyPI
Before you install
Low install friction—pure Python, no runtime dependencies. However, the package is abandoned; last release was 2020-02-09 and no updates have been made since. Use only if the existing feature set meets your needs and you're comfortable maintaining a fork if issues arise.
License in practice
MIT license (permissive); you may use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
Quickstart
pip install datetime-quarter
from datetime import date
from datetime_quarter import DateQuarter
q = DateQuarter(2019, 4)
print(q) # 2019 4Q
print(q.start_date())
print(q.end_date())Verify before relying
- Whether the package works correctly with modern Python versions given its abandoned status and lack of recent testing.
- Whether quarter numbering follows ISO 8601 or a different standard, and whether it handles fiscal years with non-standard quarter boundaries.
- The correct import path for the DateQuarter class (fact sheet shows usage but not the exact module name).
Package facts
| License | permissive license permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Abandoned 2,378 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 149,317 / month, #10,995 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3 |
Evidence: datetime_quarter-1.0.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “quarter date handling”
- datetime-quarterAdds quarter-based date handling to Python's datetime module, letting…
- fiscalyearProvides fiscal year, quarter, month, and day abstractions that…
- python-dateutilProvides parsing, arithmetic, and recurrence rule computation for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also fiscalyear · datedelta · cftime · lunardate · chinese-calendar · dateutils · LunarCalendar · nc-time-axis · zhdate · tkcalendar