Registry / data / business-duration

business-duration

library0.68pypypi✓ verified 87d ago

The `business-duration` library calculates the duration between two dates and times, excluding weekends, public holidays, and non-business hours. It provides a single function, `businessDuration`, that can compute results in days, hours, minutes, or seconds. The project is actively maintained with irregular releases, with the latest version (0.68) released in October 2025.

data workflow

pip install business-duration

github ↗package ↗

INSTALL

IMPORT

SIG · BUSINESS-DURATION

business-duration

datapythonv0.68

Install

8.4s avg

Import

—

Disk

165MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.68 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 0.000s · 166MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 8.4s · import 0.000s · 159MB

165MB installed

● package 165MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

businessDuration

✓ from business_duration import businessDuration

This example calculates the business duration in hours between two specific dates, excluding weekends and US public holidays in California, and considering a defined daily business hour range.

from business_duration import businessDuration import pandas as pd import holidays as pyholidays from datetime import time # Start date must be in standard python datetime format start_date = pd.to_datetime('2017-07-01 02:02:00') # End date must be in standard python datetime format end_date = pd.to_datetime('2017-07-07 04:48:00') # Business open hour must be in standard python time format (Hour, Min, Sec) biz_open_time = time(7, 0, 0) # Business close hour must be in standard python time format (Hour, Min, Sec) biz_close_time = time(17, 0, 0) # US public holidays for California US_holiday_list = pyholidays.US(state='CA') # Business duration can be 'day', 'hour', 'min', 'sec' unit_hour = 'hour' # Calculate and print the business duration result = businessDuration( startdate=start_date, enddate=end_date, starttime=biz_open_time, endtime=biz_close_time, holidaylist=US_holiday_list, unit=unit_hour ) print(f"Business duration: {result} {unit_hour}s") # Expected result: 30.0 hours (July 1st, 2nd are weekends, 4th is a US public holiday. 3 business days * 10 hours/day = 30 Hours).

Debug

Known issues

gotchaThe `businessDuration` function expects `datetime.datetime` or `datetime.date` objects for `startdate` and `enddate`, and `datetime.time` objects for `starttime` and `endtime`. Passing pandas Series directly to these parameters will result in a `ValueError`.

fix

Iterate over the DataFrame or apply the function row-wise, ensuring individual datetime objects are passed for each calculation. Convert Series elements using `.dt.to_pydatetime()` or `pd.to_datetime(series_element)`.

affects: All versions

gotchaHoliday lists must be compatible with the format expected by the `holidaylist` parameter. The recommended way is to use the `holidays` library (e.g., `holidays.US()`), which provides a dictionary-like object of dates. Simply passing a list of strings or improperly formatted date objects may lead to holidays not being excluded.

fix

Ensure `holidaylist` is an iterable of `datetime.date` objects or an object from the `holidays` library, as shown in the quickstart. For custom holidays, create a list of `datetime.date` objects.

affects: All versions

gotchaThe library primarily handles duration based on provided local dates/times and does not inherently manage timezones or Daylight Saving Time (DST) transitions. If timezone-aware calculations are critical, ensure your input `datetime` objects are timezone-aware and handle any DST implications externally before passing to `businessDuration`.

fix

Convert `datetime` objects to a consistent timezone (e.g., UTC) or apply timezone-aware adjustments before calling `businessDuration` if DST or differing timezones are a concern.

affects: All versions

Errors

Common errors & fixes

ValueError: The truth value of a Series is ambiguous. Use a.empty, a.bool(), a.item(), a.any() or a.all().

Attempting to pass a pandas Series (e.g., a DataFrame column) directly to `startdate`, `enddate`, or other parameters of `businessDuration` that expect single scalar values.

fix

Apply the `businessDuration` function row-wise or in a loop. For example, `df.apply(lambda row: businessDuration(startdate=row['start_col'], enddate=row['end_col'], ...), axis=1)`.

TypeError: 'str' object cannot be interpreted as an integer

Passing a string to a parameter that expects an integer or a `datetime.time` object, often related to `starttime` or `endtime` if not correctly constructed.

fix

Ensure `starttime` and `endtime` are `datetime.time` objects (e.g., `time(9, 0, 0)` for 9:00 AM) and `startdate`/`enddate` are `datetime.datetime` or `datetime.date` objects.

Incorrect holiday exclusion / holidays are not being recognized.

The `holidaylist` parameter is provided in an unexpected format, or the dates within it do not match the `datetime.date` objects being evaluated.

fix

Verify that your `holidaylist` contains `datetime.date` objects. If using the `holidays` library, ensure it's imported as `pyholidays` and correctly initialized, e.g., `US_holiday_list = pyholidays.US(state='CA')`.

Upgrade

Version history

0.68latest on PyPI · released Oct 12, 2025

Audit

Dependencies

pandasoptionalUsed in examples for datetime handling (e.g., `pd.to_datetime`).

holidaysoptionalUsed in examples to provide a list of public holidays for exclusion.

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/gnaneshwar441/Business_Duration ↗

packagehttps://pypi.org/project/business-duration/ ↗