i. vdZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z erddl mZejjZ ddlZn #e$rdZYnwxYwdejdejd ejfd Z dd eejzejzejzd edzdejdzd efd Z ddeejzejzejzdzd edzdejdzd edzfdZ ddedzdejdzd ejdzfdZddd ejdzfdZdejd efdZded ejfdZ dejdzded eejzdzfdZ!dS)aThis module contains helper functions related to datetime and timestamp conversations. .. versionchanged:: 20.0 Previously, the contents of this module were available through the (no longer existing) module ``telegram._utils.helpers``. Warning: Contents of this module are intended to be used internally by the library and *not* by the user. Changes to this module are not considered breaking changes and may not be documented in the changelog. N) TYPE_CHECKING)warn)PTBDeprecationWarning)Botdatetimetzinforeturnc|tur|tStjt5t |t jr!||cdddS dddn #1swxYwY|j ||S| |S)z%>%@%@@@+sU{++1"[00 ~+sx((<|11 K$6$@&2  &**,,%,,..--nkJJ  (&nf==N N1133 3 3 cm333 3N+N;;;+s|,,9   %";77K+K888 Yk):):)CYYY Z ZZdt_objcF|tt|||ndS)z Wrapper over :func:`to_float_timestamp` which returns an integer (the float value truncated down to the nearest integer). See the documentation for :func:`to_float_timestamp` for more details. N)r#r1)r3rrs r to_timestampr5s0   v':F C CDDD r2unixtimec^|dStj||tn|S)ai Converts an (integer) unix timestamp to a timezone aware datetime object. :obj:`None` s are left alone (i.e. ``from_timestamp(None)`` is :obj:`None`). Args: unixtime (:obj:`int`): Integer POSIX timestamp. tzinfo (:obj:`datetime.tzinfo`, optional): The timezone to which the timestamp is to be converted to. Defaults to :obj:`None`, in which case the returned datetime object will be timezone aware and in UTC. Returns: Timezone aware equivalent :obj:`datetime.datetime` value if :paramref:`unixtime` is not :obj:`None`; else :obj:`None`. Nr)rrr%r )r6rs rfrom_timestampr8s2$t < % %h&.33f % U UUr2botz Bot | NonecT|dSt|dr|jr |jjSdS)z Extracts the timezone info from the default values of the bot. If the bot has no default values, :obj:`None` is returned. Ndefaults)hasattrr;r)r9s rextract_tzinfo_from_defaultsr=s9 {tsJ#CL#|"" 4r2c|j%|tjj}|S)z Converts a datetime object to a float timestamp (with sub-second precision). If the datetime object is timezone-naive, it is assumed to be in UTC. Nr )rr rtimezoneutc timestamp)r3s rr)r)s6 }s|'788     r2rc tj|S#tj$r}tjd|d|d}~wwxYw)z|Wrapper around the `ZoneInfo` constructor with slightly more helpful error message in case tzdata is not installed. zNo time zone found with key z. Make sure to use a valid time zone name and correctly install the tzdata (https://pypi.org/project/tzdata/) package if your system does not provide the time zone data.N)zoneinfoZoneInfoZoneInfoNotFoundError)rerrs r get_zone_inforGsj $$$  ), ?2 ? ? ?    sA>Avalue attributec<|dStjdddvr|St t dd|dd |x}rt|n|S) aP Convert a `datetime.timedelta` to seconds or return it as-is, based on environment config. This utility is part of the migration process from integer-based time representations to using `datetime.timedelta`. The behavior is controlled by the `PTB_TIMEDELTA` environment variable. Note: When `PTB_TIMEDELTA` is not enabled, the function will issue a deprecation warning. Args: value (:obj:`datetime.timedelta`): The timedelta value to process. attribute (:obj:`str`): The name of the attribute at the caller scope, used for warning messages. Returns: - :obj:`None` if :paramref:`value` is None. - :obj:`datetime.timedelta` if `PTB_TIMEDELTA=true` or ``PTB_TIMEDELTA=1``. - :obj:`int` if the total seconds is a whole number. - float: otherwise. N PTB_TIMEDELTAfalse)true1zv22.2z%In a future major version attribute `z` will be of type `datetime.timedelta`. You can opt-in early by setting `PTB_TIMEDELTA=true` or ``PTB_TIMEDELTA=1`` as an environment variable.) stacklevel) osgetenvlowerstriprrr" is_integerr#)rHrIsecondss rget_timedelta_valuerWs, }t y'**002288::mKK   BI B B B  **,, ,G 8 8 : : G r2)NN)N)"__doc__rrrrQrrCtypingrtelegram._utils.warningsrtelegram.warningsrtelegramrr?r@r r ImportErrorrrr$r!r1r#r5r8r=r)strrDrGrWr2rr`s&    ))))))333333 lKKKK DDD 's| 'SZ 'CL ' ' ' '")- $c[c[&5@c[c[ J c[ c[c[c[c[P)- $ CM !CL 038 ;d B J  4Z (!%VVDjV J V \DVVVV0 l szD7H    % c h/    's}t3''cmH[^bHb''''''sAA  A