Skip to content

Python date package according to ISO8601 with useful date routines, holiday calculation and an ISO8601 parser

License

Notifications You must be signed in to change notification settings

derlinkshaender/dt8601

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dt8601

dt8601 (short for "dates in ISO8601 logic") provides useful functionality to work with gregorian dates. This is my first open source project in Python, so please bear with me. The code is based on a date library I wrote back in to 90s in another language and has proven to be very helpful when you have to work with date arithmetic.

Quick start

dt8601 provides two objects to work with dates. One allows for easy storages and calculations with a date and the other provides functionality that is associated with a calendar year.

Typical usage in most cases is as easy as this:

#!/usr/bin/env python

import dt8601

ymd = dt8601.IsoDate(2013, 06, 25, 'DE')
year = dr8601.IsoYear(2013)

num_weeks = year.week_count  # number if weeks in 2013

print(ymd.day_of_year())   # day of year
print(ymd.day_of_week())   # get week day for 2013-06-25
print(ymd.week_of_year())  # get ISO calendar week for 2013-06-25

You would like to get a list of all the start dates for every ISO calendar week in 2013? As easy as:

from dt8601 import IsoYear

yr = IsoYear(2013)

for the_week in yr.iso_weeks:
    print(the_week['start'])

You can find more information in the docs folder (es gibt auch eine deutsche Doku dort!)

Where's the documentation?

You may find all the reStructured text sources for the documentation here in the repo. Currently there is a German version and an English version available (I'm a bit shaky on my English, so I would be glad to receive some feedback on possible improvements, thanks).

If you just like to read the redered version, please click here: http://pythonhosted.org/dt8601/

Thanks also to

This module is a result of porting and reworking a Borland Delphi library that is now more than 20 years old (yes, we had computers back then <g>). Many people inspired this library, helped and added code or explained things.

Bernd Strehuber - Holiday calculations Carley Phillips - Julian date calculations Jeff Duntemann - Weekday calculations Judson McClendon - Easter calculations Martin Austermeier - Weekday calculations Paul Schlyter - Easter calculation Pit Biernath - Julian date calculations Scott Bussinger - Julian date calculations Markus Kuhn for his ISO8601 summary

Also many thanks to the Wikipedia authors of the ISO8601 articles and last, but not least, the awesome group of people on http://www.stackoverflow.com

About

Python date package according to ISO8601 with useful date routines, holiday calculation and an ISO8601 parser

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published