bizdays

library1.0.19pypypi✓ verified 84d ago

bizdays is a Python library for business days calculations, including offsetting dates, computing business days between dates, and generating calendars with custom holidays. Current version: 1.0.19, with monthly releases.

data

pip install bizdays

package ↗

INSTALL

IMPORT

SIG · BIZDAYS

bizdays

datapythonv1.0.19

Install

8.4s avg

Import

900ms

Disk

173MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.0.19 · 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.95 runs

installs and imports cleanly · install 0.0s · import 0.928s · 168.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 8.4s · import 0.872s · 161MB

173MB installed

● package 173MB

Code

Verified usage

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

Calendar

✓ from bizdays import Calendar

✗ from bizdays.calendar import Calendar

Calendar is a top-level export, not a submodule.

Basic usage: load a calendar and perform business day calculations.

from bizdays import Calendar # Create a calendar with Brazil's holidays cal = Calendar.load('Brazil/ANBIMA') # Calculate business days offset result = cal.offset('2026-05-01', 5) print(result) # Should print next business day after 5 days # Calculate business days between dates days = cal.bizdays('2026-05-01', '2026-05-10') print(days) # Number of business days

Debug

Known issues

breakingIn version 1.0, the library dropped support for Python 3.6 and below. Ensure your Python version is >=3.9 as per current requirements.

fix

Upgrade Python to 3.9 or higher.

affects: 1.0.0 and above

gotchaCalendar.load('Brazil/ANBIMA') relies on an internet connection to fetch holiday data. If offline, the call will fail.

fix

Pre-load the calendar and cache it, or use a local JSON file with `Calendar` constructor.

affects: all

gotchaDate arguments to bizdays functions must be strings in 'YYYY-MM-DD' format or datetime.date objects. Passing pandas Timestamps may cause unexpected behavior.

fix

Convert Timestamps using .date() or format to string before passing.

affects: all

deprecatedThe `load` method with a string argument (e.g., 'Brazil/ANBIMA') is stable but may be deprecated in future in favor of a more explicit API. Check release notes for updates.

fix

Monitor changelog for any changes to calendar loading.

affects: 1.0.x

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'bizdays.utils'

Importing from a non-existent submodule. bizdays does not expose a 'utils' submodule.

fix

Use `from bizdays import Calendar` instead.

ValueError: Invalid date format. Use YYYY-MM-DD.

Passing a date object without converting to string or using an incorrect format.

fix

Ensure dates are strings in 'YYYY-MM-DD' format or datetime.date objects.

requests.exceptions.ConnectionError: Failed to load calendar from remote

No internet connection when using Calendar.load with a remote calendar name.

fix

Use a local calendar file or ensure internet access.

Upgrade

Version history

1.0.19latest on PyPI · released Jan 4, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/bizdays/ ↗