ISO Week Date¶

iso-week-date is a toolkit to work with strings representingISO Week date in two formats, namely:

• Week formatYYYY-WNN (date format%Y-W%V)
• Week date formatYYYY-WNN-D (date format%Y-W%V-%u)

whereYYYY represents the year,W is a literal,NN represents the week number, andD represents the day of the week.

In a nutshell it provides:

• IsoWeek andIsoWeekDate classes that implement a series of methods to work with ISO Week (Date) formats directly, avoiding the pitfalls of going back and forth between string, date and datetime python objects.
• pandas andpolars functionalities (and namespaces) to work with series of ISO Week dates.
• pydantic compatible types, as described in their docs section on how tocustomize validation with__get_pydantic_core_schema__

Documentation |Source Code |Issue Tracker

Installation¶

TL;DR: you can install the package with pip:

python-mpipinstalliso-week-date

For more information please refer to theinstallation section.

Usage¶

To get started withIsoWeek andIsoWeekDate classes please refer to thequickstart section.

To check examples on how to work withpandas andpolars functionalities please refer to thedataframe modules section.

Contributing¶

Please read thecontributing guidelines in the documentation site.

License¶

The project has aMIT Licence.