Skip to main content

Python library for generating business dates for fast date operations and rich functionality.

Project description

A fast, efficient Python library for generating business dates inherited from float for fast date operations. Typical banking business methods are provided like business holidays adjustment, day count fractions. Beside dates generic business periods offer to create time periods like ‘10Y’, ‘3 Months’ or ‘2b’. Periods can easily added to business dates.

Example Usage

from datetime import date

from businessdate import BusinessDate, BusinessPeriod

>>> BusinessDate(20140101).add_days(10)

>>> BusinessPeriod('1Y').add_months(3)

>>> BusinessDate(20140101) + BusinessPeriod('1Y3M')


The latest stable version can always be installed or updated via pip:

$ pip install businessdate

If the above fails, please try easy_install instead:

$ easy_install businessdate


# Simplest example possible

>>> from datetime import date
>>> from businessdate import BusinessDate, BusinessPeriod, BusinessRange, BusinessSchedule
>>> BusinessDate.from_date(date(2014, 1, 1)) == BusinessDate(20140101)

>>> BusinessDate(20140101) + '1y6m'

>>> BusinessDate(20140101).adjust_follow()

>>> BusinessPeriod('1Y')==BusinessPeriod(years=1)

>>> BusinessPeriod('1Y')

>>> BusinessPeriod('1Y').add_businessdays(3)

>>> BusinessPeriod('1Y') + '1y6m'

>>> sd = BusinessDate(20151231)
>>> ed = BusinessDate(20201231)
>>> BusinessRange(sd, ed, '1y', ed)
[20151231, 20161231, 20171231, 20181231, 20191231]

>>> BusinessSchedule(sd, ed, '1y', ed)
[20151231, 20161231, 20171231, 20181231, 20191231, 20201231]

>>> BusinessSchedule(sd, ed, '1y', ed).first_stub_long()
[20151231, 20171231, 20181231, 20191231, 20201231]

Development Version

The latest development version can be installed directly from GitHub:

$ pip install --upgrade git+


Issues and Pull Requests are always welcome.


Code and documentation are available according to the Apache Software License (see LICENSE).

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
businessdate-0.4-py2-none-any.whl (17.6 kB) Copy SHA256 hash SHA256 Wheel py2 (28.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page