{"id":23367,"library":"bizdays","title":"bizdays","description":"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.","status":"active","version":"1.0.19","language":"python","source_language":"en","source_url":"https://github.com/wilsonfreitas/python-bizdays","tags":["business-days","calendar","holidays","date-calculations"],"install":[{"cmd":"pip install bizdays","lang":"bash","label":"PyPI install"}],"dependencies":[],"imports":[{"note":"Calendar is a top-level export, not a submodule.","wrong":"from bizdays.calendar import Calendar","symbol":"Calendar","correct":"from bizdays import Calendar"}],"quickstart":{"code":"from bizdays import Calendar\n\n# Create a calendar with Brazil's holidays\ncal = Calendar.load('Brazil/ANBIMA')\n\n# Calculate business days offset\nresult = cal.offset('2026-05-01', 5)\nprint(result)  # Should print next business day after 5 days\n\n# Calculate business days between dates\ndays = cal.bizdays('2026-05-01', '2026-05-10')\nprint(days)  # Number of business days\n","lang":"python","description":"Basic usage: load a calendar and perform business day calculations."},"warnings":[{"fix":"Upgrade Python to 3.9 or higher.","message":"In version 1.0, the library dropped support for Python 3.6 and below. Ensure your Python version is >=3.9 as per current requirements.","severity":"breaking","affected_versions":"1.0.0 and above"},{"fix":"Pre-load the calendar and cache it, or use a local JSON file with `Calendar` constructor.","message":"Calendar.load('Brazil/ANBIMA') relies on an internet connection to fetch holiday data. If offline, the call will fail.","severity":"gotcha","affected_versions":"all"},{"fix":"Convert Timestamps using .date() or format to string before passing.","message":"Date arguments to bizdays functions must be strings in 'YYYY-MM-DD' format or datetime.date objects. Passing pandas Timestamps may cause unexpected behavior.","severity":"gotcha","affected_versions":"all"},{"fix":"Monitor changelog for any changes to calendar loading.","message":"The `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.","severity":"deprecated","affected_versions":"1.0.x"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use `from bizdays import Calendar` instead.","cause":"Importing from a non-existent submodule. bizdays does not expose a 'utils' submodule.","error":"ModuleNotFoundError: No module named 'bizdays.utils'"},{"fix":"Ensure dates are strings in 'YYYY-MM-DD' format or datetime.date objects.","cause":"Passing a date object without converting to string or using an incorrect format.","error":"ValueError: Invalid date format. Use YYYY-MM-DD."},{"fix":"Use a local calendar file or ensure internet access.","cause":"No internet connection when using Calendar.load with a remote calendar name.","error":"requests.exceptions.ConnectionError: Failed to load calendar from remote"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}