:py:mod:`datetime`
==================

.. py:module:: conda.common.datetime

.. autoapi-nested-parse::

   Date, time, duration, and timestamp helpers.




Functions
---------

.. autoapisummary::

   conda.common.datetime.parse_duration
   conda.common.datetime.parse_datetime_to_timestamp
   conda.common.datetime.normalize_timestamp_seconds



Attributes
----------

.. autoapisummary::

   conda.common.datetime.COMPACT_DURATION_UNITS
   conda.common.datetime.MAX_SECONDS_TIMESTAMP
   conda.common.datetime._COMPACT_DURATION_RE
   conda.common.datetime._ISO8601_DURATION_RE
   conda.common.datetime._DATE_ONLY_RE
   conda.common.datetime._COMPACT_DATE_ONLY_RE


.. py:data:: COMPACT_DURATION_UNITS

.. py:data:: MAX_SECONDS_TIMESTAMP
   :value: 253402300799


.. py:data:: _COMPACT_DURATION_RE

.. py:data:: _ISO8601_DURATION_RE

.. py:data:: _DATE_ONLY_RE

.. py:data:: _COMPACT_DATE_ONLY_RE

.. py:function:: parse_duration(value: str) -> datetime.timedelta | None

   Parse plain, compact, or ISO 8601 duration strings.


.. py:function:: parse_datetime_to_timestamp(value: str) -> float | None

   Parse an ISO/RFC 3339 datetime into a POSIX timestamp.

   Naive datetimes are interpreted as UTC. Date-only values are interpreted
   as the start of the following UTC day.


.. py:function:: normalize_timestamp_seconds(value: str | int | float) -> float

   Normalize a seconds-or-milliseconds POSIX timestamp to seconds.