python_technical_primitives.datetime.operations
===============================================

.. py:module:: python_technical_primitives.datetime.operations

.. autoapi-nested-parse::

   Date/time utility operations.



Functions
---------

.. autoapisummary::

   python_technical_primitives.datetime.operations.utc_now
   python_technical_primitives.datetime.operations.add_days
   python_technical_primitives.datetime.operations.add_hours
   python_technical_primitives.datetime.operations.is_expired
   python_technical_primitives.datetime.operations.days_until
   python_technical_primitives.datetime.operations.to_iso_string
   python_technical_primitives.datetime.operations.from_iso_string


Module Contents
---------------

.. py:function:: utc_now() -> datetime.datetime

   Get current UTC datetime with timezone info.


.. py:function:: add_days(dt: datetime.datetime, days: int) -> datetime.datetime

   Add days to datetime.


.. py:function:: add_hours(dt: datetime.datetime, hours: int) -> datetime.datetime

   Add hours to datetime.


.. py:function:: is_expired(expiry_dt: datetime.datetime, reference_dt: Optional[datetime.datetime] = 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


.. py:function:: days_until(target_dt: datetime.datetime, reference_dt: Optional[datetime.datetime] = 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)


.. py:function:: to_iso_string(dt: datetime.datetime) -> str

   Convert datetime to ISO 8601 string.


.. py:function:: from_iso_string(iso_str: str) -> datetime.datetime

   Parse ISO 8601 string to datetime.