businesstimedelta
Timedelta for business time. Supports exact amounts of time (hours, seconds), custom schedules, holidays, and time zones.
Decision gist · record as of 2026-08-14
No—not recommended for new projects. The package is abandoned (last commit 2022-01-26) and will not receive updates. While it has low install friction and a permissive MIT license, the lack of maintenance means you will inherit any compatibility issues and cannot rely on bug fixes. Consider an actively maintained alternative if business time calculation is critical to your application.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with only 2 runtime dependencies (pytz and holidays).
- However, the package is abandoned—last commit was 2022-01-26—so it will not receive bug fixes or updates.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.
last release 2019-09-07 (2533 days) · last repo commit 2022-01-26 · 38 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,398,661 downloads/mo, #3,956 on PyPI
Alternatives
Verify before relying
import datetime
import businesstimedelta
workday = businesstimedelta.WorkDayRule(
start_time=datetime.time(9),
end_time=datetime.time(18),
working_days=[0, 1, 2, 3, 4])
businesshrs = businesstimedelta.Rules([workday])
start = datetime.datetime(2016, 1, 18, 9, 0, 0)
end = datetime.datetime(2016, 1, 22, 18, 0, 0)
bdiff = businesshrs.difference(start, end)
print(bdiff.hours)- Whether the package works reliably with modern Python versions despite being abandoned since 2022
- Active maintenance or community forks that may address compatibility issues
What it is and what it does
BusinessTimeDelta is a Python library that calculates the elapsed time between two datetimes while respecting business hours, not calendar time. It lets you define working schedules (start/end times, working days), exclude lunch breaks and holidays, and perform arithmetic on business time intervals. The package integrates with pytz for timezone handling and the holidays library for holiday exclusion.
You define your business rules once—specifying work hours, days of the week, lunch breaks, and holidays—then use those rules to compute the actual working time between any two datetimes or to add/subtract business time from a given moment. This is useful for SLAs, ticket response times, project scheduling, and any domain where elapsed time should count only working hours.
Use it for
- Calculate SLA compliance: measure working hours elapsed since a support ticket was opened, excluding nights and weekends.
- Project scheduling: add business days and hours to a start date to estimate a realistic delivery deadline.
- Multi-timezone overlap: find the working-hour intersection between teams in different time zones.
- Payroll and shift tracking: compute hours worked across day and night shifts, accounting for lunch breaks.
- Holiday-aware reporting: exclude company holidays and local holidays from time-tracking calculations.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—not recommended for new projects.
The package is abandoned (last commit 2022-01-26) and will not receive updates. While it has low install friction and a permissive MIT license, the lack of maintenance means you will inherit any compatibility issues and cannot rely on bug fixes. Consider an actively maintained alternative if business time calculation is critical to your application.
Install
businesstimedelta on PyPI
Before you install
Low install friction with only 2 runtime dependencies (pytz and holidays). However, the package is abandoned—last commit was 2022-01-26—so it will not receive bug fixes or updates.
License in practice
MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.
Quickstart
import datetime
import businesstimedelta
workday = businesstimedelta.WorkDayRule(
start_time=datetime.time(9),
end_time=datetime.time(18),
working_days=[0, 1, 2, 3, 4])
businesshrs = businesstimedelta.Rules([workday])
start = datetime.datetime(2016, 1, 18, 9, 0, 0)
end = datetime.datetime(2016, 1, 22, 18, 0, 0)
bdiff = businesshrs.difference(start, end)
print(bdiff.hours)Verify before relying
- Whether the package works reliably with modern Python versions despite being abandoned since 2022
- Active maintenance or community forks that may address compatibility issues
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespytzholidays |
| Maintenance | Abandoned 2,533 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,398,661 / month, #3,956 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 2.7Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Topic :: Office/Business :: Scheduling |
Evidence: businesstimedelta-1.0.1-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 › “business hours time calculation”
- businesstimedeltaCalculates elapsed working time between two datetimes, accounting for…
- business-durationCalculates business duration between two dates by excluding weekends,…
- suntimeCalculates sunrise and sunset times for any geographic location and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Scheduling packages
Generates country- and subdivision-specific government holiday calendars on demand, supporting 250 country codes with optional language localization and holiday categories.
OR-Tools provides constraint programming, linear and mixed-integer programming, vehicle routing, and graph algorithm solvers developed at Google for operations research problems.
Expands recurring iCalendar events (RFC 5545) into individual occurrences, handling repetitions, removals, and edits across events, todos, journals, and alarms.
Install it if you work with iCalendar data and need to expand recurrence rules.
A CalDAV (RFC4791) client library for Python that lets you create, modify, and search calendar events on CalDAV servers, with both synchronous and asynchronous APIs.
Reads and writes iCalendar (RFC 5545) files in a pythonic, developer-friendly way, handling calendar events and todos without requiring knowledge of the iCalendar format.
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.
Install it if fiscal periods are part of your domain; skip it if you only work with calendar years.
See also business-duration · tempora · dateutils · delta · pandas_market_calendars · chinese-calendar