j$ddlmZddlmZmZmZedZdgZddededefdZd Z Gd d eZ Gd d e Z dS)wraps)datetime timedeltatzinfoenfolddtfoldreturnc.||S)aReturns a datetime with the ``fold`` attribute set to ``fold``. :param fold: The value for the ``fold`` attribute, either 0 or 1. :return: A :class:`datetime.datetime` with the requested ``fold`` value. .. versionadded:: 2.6.0 r replace)r r s R/data/share/cad/hardware/.venv/lib/python3.11/site-packages/dateutil/tz/_common.pyrrs ::4:  c<tfd}|S)z The CPython version of ``fromutc`` checks that the input is a ``datetime`` object and that ``self`` is attached as its ``tzinfo``. ct|tstd|j|urt d||S)N&fromutc() requires a datetime argumentdt.tzinfo is not self) isinstancer TypeErrorr ValueError)selfr fs rfromutcz)_validate_fromutc_inputs..fromutc!sQ"h'' FDEE E 9D 455 5qr{{rr)rrs` r_validate_fromutc_inputsrs5  1XXX Nrc:eZdZdZdZdZdZedZdS)_tzinfoz= Base class for all ``dateutil`` ``tzinfo`` objects. c,||}t|d}t|d}||k}|d|dk}|o| S)6 Whether or not the "wall time" of a given datetime is ambiguous in this zone. :param dt: A :py:class:`datetime.datetime`, naive or time zone aware. :return: Returns ``True`` if ambiguous, ``False`` otherwise. .. versionadded:: 2.6.0 rrrr N)rr utcoffset)rr wall_0wall_1 same_offsetsame_dts r is_ambiguousz_tzinfo.is_ambiguous2sZZtZ $ $######&&((F,<,<,>,>> ...--t1L1LL*{?*rc||r@||z }t|||z k}nd}|S)a Determine the fold status of a "wall" datetime, given a representation of the same datetime as a (naive) UTC datetime. This is calculated based on the assumption that ``dt.utcoffset() - dt.dst()`` is constant for all datetimes, and that this offset is the actual number of hours separating ``dt_utc`` and ``dt_wall``. :param dt_utc: Representation of the datetime as UTC :param dt_wall: Representation of the datetime as "wall time". This parameter must either have a `fold` attribute or have a fold-naive :class:`datetime.tzinfo` attached, otherwise the calculation may fail. r)r(intr#dst)rdt_utcdt_wall delta_wall_folds r _fold_statusz_tzinfo._fold_statusKs["   W % %  6)J v'7'7'9'9FJJLL'HIJJEEE rc|}|td|}|td||z }||z }t|d}|td||zS) Given a timezone-aware datetime in a given timezone, calculates a timezone-aware datetime in a new timezone. Since this is the one time that we *know* we have an unambiguous datetime object, we take this opportunity to determine whether the datetime is ambiguous and in a "fold" state (e.g. if it's the first occurrence, chronologically, of the ambiguous datetime). :param dt: A timezone-aware :class:`datetime.datetime` object. Nz0fromutc() requires a non-None utcoffset() resultz*fromutc() requires a non-None dst() resultr rz;fromutc(): dt.dst gave inconsistent results; cannot convert)r#rr+r)rr dtoffdtdstdeltas r_fromutcz_tzinfo._fromutcds  =&'' '  =IJJ J  e r"""&&(( =788 8Ezrcz||}|||}t||S)r2r)r6r0r)rr r-r/s rrz_tzinfo.fromutcsA--##!!"g..gE****rN) __name__ __module__ __qualname____doc__r(r0r6rrrrrr-sh+++22###J+++++rrcpeZdZdZdZdZdZdZdZdZ dZ d Z e d Z d Zd ZejZd S) tzrangebasea This is an abstract base class for time zones represented by an annual transition into and out of DST. Child classes should implement the following methods: * ``__init__(self, *args, **kwargs)`` * ``transitions(self, year)`` - this is expected to return a tuple of datetimes representing the DST on and off transitions in standard time. A fully initialized ``tzrangebase`` subclass should also provide the following attributes: * ``hasdst``: Boolean whether or not the zone uses DST. * ``_dst_offset`` / ``_std_offset``: :class:`datetime.timedelta` objects representing the respective UTC offsets. * ``_dst_abbr`` / ``_std_abbr``: Strings representing the timezone short abbreviations in DST and STD, respectively. * ``_hasdst``: Whether or not the zone has DST. .. versionadded:: 2.6.0 c td)Nz%tzrangebase is an abstract base class)NotImplementedErrorrs r__init__ztzrangebase.__init__s!"IJJJrcT||}|dS|r|jS|jSN)_isdst _dst_offset _std_offsetrr isdsts rr#ztzrangebase.utcoffsets5 B =4  $# ## #rcT||}|dS|r|jStSrD)rE_dst_base_offsetZEROrHs rr+ztzrangebase.dsts1 B =4  ( (KrcH||r|jS|jSrD)rE _dst_abbr _std_abbr)rr s rtznameztzrangebase.tznames$ ;;r?? "> !> !rct|tstd|j|urt d||j}||||zS|\}}||jz}||jz}||f}| d}| ||}|r ||j z}n ||jz}t| o| |} t|| S)z, Given a datetime in UTC, return local time rrNr"r)rrrrr transitionsyearr#rGr _naive_isdstrFr*r(r) rr rRdstondstoffutc_transitionsr,rIr-r/s rrztzrangebase.fromutcs#"h'' FDEE E 9D 455 5&&rw//  r*** *$ v !!$"" &/4((!!&/::  ,4++GG4++GI<$"3"3G"<"<==gE****rc|jsdS||j\}}|d}||cxko ||jzkncS)r!FNr")hasdstrRrSrrK)rr startends rr(ztzrangebase.is_ambiguoussi{ 5%%bg.. s ZZtZ $ $r7777C$"7777778rc|jsdS|dS||j}|dS|d}|||}|s||r|j S|S)NFr")rYrRrSrrTr(r )rr rRrIs rrEztzrangebase._isdst s{ 5 Z4&&rw//  5 ZZtZ $ $!!"k22 **2.. w; Lrc|\}}|d}||kr||cxko|knc}n||cxko|knc }|S)Nr"r)rr rRrUrVrIs rrTztzrangebase._naive_isdstss# v ZZtZ $ $ 6>>R((((&((((EE",,,,u,,,,,E rc |j|jz SrD)rFrGrAs rrKztzrangebase._dst_base_offset+s$"222rNc d|jjzS)Nz%s(...)) __class__r8rAs r__repr__ztzrangebase.__repr__1s4>222r)r8r9r:r;rBr#r+rPrr(rErTpropertyrK__hash__raobject __reduce__r<rrr>r>s*KKK$$$""" +++B999,*   33X3H333"JJJrr>N)r ) functoolsrrrrrL__all__r*rrrr>r<rrrhs0000000000y|| * ! !x !s !8 ! ! ! !"p+p+p+p+p+fp+p+p+fT#T#T#T#T#'T#T#T#T#T#r