workadays

What it is and what it does

Workadays is a date-calculation library that computes working days, calendar days, and financial 360-day intervals between two dates. It includes built-in holiday calendars for Brazil (including state-level holidays), United States, Luxembourg, United Kingdom, and Argentina, accounting for weekends and holidays in its calculations.

The package provides functions to count working days between dates (networkdays), add a number of working days to a start date (workdays), calculate calendar days or 360-day basis intervals (days and days360 with American or European methods), and check whether a specific date is a holiday, weekend, or working day. It depends on python-dateutil and six for date handling and Python 2/3 compatibility.

Use it for:

• Calculate business day deadlines in financial contracts or loan agreements using 30/360 day-count conventions
• Determine working-day delivery dates in e-commerce or logistics systems accounting for regional holidays
• Compute accrued interest or bond pricing using American or European 360-day basis methods
• Validate whether a date is a working day in payroll or HR systems for Brazil or other supported countries
• Generate holiday calendars for specific countries and years for scheduling or calendar applications

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Calculates working days, calendar days, and 360-day basis intervals between dates, with holiday calendars for Brazil, United States, Luxembourg, United Kingdom, and Argentina.

Yes, if you need working-day calculations for Brazil or the other supported countries and can accept a dormant package. The low install friction and permissive license make it a practical choice for financial calculations or business logic. However, verify that holiday calendars remain accurate for your use year, and monitor whether the package receives updates for future Python versions—no maintenance activity has been recorded since release.

Install

workadays on PyPI

pip install workadays

uv add workadays

poetry add workadays

Installing workadays

Before you install

Low install friction with only two runtime dependencies (python-dateutil and six). Package is dormant since its 2023-12-30 release—no commits or updates tracked since then, which may affect reliability for future Python versions or holiday calendar changes.

License in practice

Licensed under MIT License with permissive treatment, allowing free use, modification, and distribution with minimal restrictions.

Quickstart

import datetime as dt
from workadays import workdays as wd

d1 = dt.date(2018, 1, 7)
d2 = dt.date(2020, 12, 31)
print(wd.networkdays(d1, d2))  # working days between dates

Verify before relying

• Whether holiday calendars are kept current for future years beyond 2023
• Python version compatibility range (requires_python field is empty in metadata)
• Whether Juneteenth and November 20 (Consciência Negra) are correctly applied in all scenarios

Package facts

Evidence: workadays-2023.12.30-py3-none-any.whl

Keywords: workdays workadays feriados holidays diasuteis uteis, dias360, days360, days

Tags

More Utilities packages