Skip to main content

Utility functions to deal with working days in date operations. With builtin localization support.

Project description

This package let you perform simple date arithmetics on standard objects taking into account working days (weekend, holidays).

Python compatibility

The package is continuosly tested on Python 2.7, 3.2, 3.3 and 3.4.




The API is simple and clear and the implementation is straightforward.

Localization - that is handling holidays for different countries - is built-in and easy to extend.


The implementation is not very optimized and it is expected to be used for small date deltas.

Currently only italian holidays are implemented, but feel free to send pull requests for your country of interest.


Check if a date is a working day

import date
import workingdays

is_today_working = workingdays.is_workingday(

Add a number of working days to a certain date

import date
import workingdays

two_workingdays_from_today = workingdays.add(, 2)

Count the number of working days between two dates

import date
import workingdays

workingdays_between_dates = workingdays.diff(date(2015, 3, 27), date(2015, 3, 25))

Compute the next working day starting from a certain date

import date
import workingdays

workingday_after_today =

Use a different localization, that is taking into account holidays for a particular country

import date
import workingdays

workingdays.is_workingday =

workingday_after_today_in_italy =

See file in the source directory to have a better idea of the API and the expected results.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyworkingdays, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size pyworkingdays-0.1.tar.gz (1.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page