philiprehberger-datetime-kit 0.1.0

Common datetime operations missing from the standard library.

philiprehberger-datetime-kit

Common datetime operations missing from the standard library.

Installation

pip install philiprehberger-datetime-kit

Usage

from philiprehberger_datetime_kit import business_days, date_range, relative

# Count business days between two dates
count = business_days("2026-03-16", "2026-03-20")  # 4

Business Days with Holidays

from philiprehberger_datetime_kit import business_days

count = business_days("2026-03-16", "2026-03-20", holidays=["2026-03-18"])  # 3

Date Range

from philiprehberger_datetime_kit import date_range

for d in date_range("2026-03-01", "2026-03-05"):
    print(d)

Relative Time

from philiprehberger_datetime_kit import relative

tomorrow = relative(days=1)
one_hour_ago = relative(hours=-1)

Start and End of Period

from philiprehberger_datetime_kit import start_of, end_of

start = start_of("month")   # first moment of current month
end = end_of("day")         # last moment of today

API

Function	Description
business_days(start, end, holidays?)	Count business days (Mon-Fri) between two dates
date_range(start, end, step?)	Yield dates from start to end inclusive
relative(days?, hours?, minutes?, seconds?)	Return UTC now offset by the given delta
start_of(unit, dt?)	Start of day/week/month/year
end_of(unit, dt?)	End of day/week/month/year

Development

pip install -e .
python -m pytest tests/ -v

License

MIT