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 datetime.date 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.

https://travis-ci.org/baxeico/pyworkingdays.svg?branch=master

Requirements

python-dateutil

Pros

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.

Cons

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.

Examples:

Check if a date is a working day

import date
import workingdays

is_today_working = workingdays.is_workingday(date.today())

Add a number of working days to a certain date

import date
import workingdays

two_workingdays_from_today = workingdays.add(date.today(), 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 = workingdays.next(date.today())

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

import date
import workingdays
import workingdays.l10n.it

workingdays.is_workingday = workingdays.l10n.it.is_workingday

workingday_after_today_in_italy = workingdays.next(date.today())

See file test.py 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

0.1

Download files

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

Source Distribution

pyworkingdays-0.1.tar.gz (1.8 kB view details)

Uploaded Source

File details

Details for the file pyworkingdays-0.1.tar.gz.

File metadata

  • Download URL: pyworkingdays-0.1.tar.gz
  • Upload date:
  • Size: 1.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyworkingdays-0.1.tar.gz
Algorithm Hash digest
SHA256 20c53d9519d477e816c617317a673ae79cf7c6367732bb82ce300801f3bc55af
MD5 e51942499692e61578e56deaa29dab55
BLAKE2b-256 10b609e7bcd27690326cc0b7dc9bd081b7bd6f78b32797d6a81e57bcd7f8b0bb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page