python_technical_primitives.datetime.operations

Date/time utility operations.

Functions

utc_now(→ datetime.datetime)

Get current UTC datetime with timezone info.

add_days(→ datetime.datetime)

Add days to datetime.

add_hours(→ datetime.datetime)

Add hours to datetime.

is_expired(→ bool)

Check if expiry datetime has passed.

days_until(→ int)

Calculate days until target datetime.

to_iso_string(→ str)

Convert datetime to ISO 8601 string.

from_iso_string(→ datetime.datetime)

Parse ISO 8601 string to datetime.

Module Contents

python_technical_primitives.datetime.operations.utc_now() datetime.datetime

Get current UTC datetime with timezone info.

python_technical_primitives.datetime.operations.add_days(dt: datetime.datetime, days: int) datetime.datetime

Add days to datetime.

python_technical_primitives.datetime.operations.add_hours(dt: datetime.datetime, hours: int) datetime.datetime

Add hours to datetime.

python_technical_primitives.datetime.operations.is_expired(expiry_dt: datetime.datetime, reference_dt: datetime.datetime | None = None) bool

Check if expiry datetime has passed.

Args:

expiry_dt: The expiration datetime to check reference_dt: Reference datetime (defaults to now)

Returns:

True if expired, False otherwise

python_technical_primitives.datetime.operations.days_until(target_dt: datetime.datetime, reference_dt: datetime.datetime | None = None) int

Calculate days until target datetime.

Args:

target_dt: Target datetime reference_dt: Reference datetime (defaults to now)

Returns:

Number of days (negative if past)

python_technical_primitives.datetime.operations.to_iso_string(dt: datetime.datetime) str

Convert datetime to ISO 8601 string.

python_technical_primitives.datetime.operations.from_iso_string(iso_str: str) datetime.datetime

Parse ISO 8601 string to datetime.