QiD% dZddlZddlZddlZddlmZmZmZerddl m Z ejjZ ddlZdejdej dejfdZ dd eeej&ejejfd eedeej defd Z dd eeej&ejejdfd eedeej deefd Z ddeedeej deejfdZdeddeej dffdZd ejdefdZy#e$rdZYwxYw)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_CHECKINGOptionalUnion)Botdatetimetzinforeturncb|tur|jtStjt5t |t jr|j|cdddS ddd|j|j|S|j|S#1swY8xYw)z%>%@@@+U|,"[00 ~+sxx(||11 K$6$6$@&2 &**,%,,.--nkJ  (&nf=N N113 3 cmm3 3N+N;;+s||,    %";7K+K88 (k):)C)C(DDXY ZZdt_objc6|tt|||SdS)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_timestampr5s.   v':F CDr2unixtimecd|ytjj|| tS|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_timestampr8s6$ << % %h&.3 % UUf % UUr2botrcf|yt|dr"|jr|jjSy)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=s/ {sJCLL||""" r2c|j*|jtjj}|j 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. r )rr rtimezoneutc timestamp)r3s rr)r)s7 }}s||'7'78    r2)NN)N)__doc__rrrrtypingrrrtelegramrr?r@r r ImportErrorrrr$r!r1r#r5r8r=r)r2rrGs&  11 ll 's|| 'SZZ 'CLL '",0#'c[ucmmS\\388CDc[!%c[ SZZ c[ c[P,0#' % chhD E!% SZZ c] ($(VsmV SZZ VcllV0 huo % D@P:Q %e DsEEE