a
&i2 @ s d Z ddlZddlZddlmZ ddlmZ zddlZddlmZ W n e y^ e
dY n0 ddl m Z g d Z
ed
Zd Zd Zd
Zdd Ze ZG dd deZG dd de ZG dd deZG dd deZdd Zdd ZdS ) z
This module provides an interface to the native time zone data on Windows,
including :py:class:`datetime.tzinfo` implementations.
Attempting to import this module on a non-Windows platform will raise an
:py:obj:`ImportError`.
N)winreg) text_type)wintypesz#Running tzwin on non-Windows system ) tzrangebase)tzwin
tzwinlocaltzres z7SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zonesz4SOFTWARE\Microsoft\Windows\CurrentVersion\Time Zonesz4SYSTEM\CurrentControlSet\Control\TimeZoneInformationc C sJ t d t j} zt | t t}W n ty< t}Y n0 | |S N)r ConnectRegistryHKEY_LOCAL_MACHINEOpenKey TZKEYNAMENTZCloseZ WindowsError TZKEYNAME9X)handle TZKEYNAME r 3/usr/lib/python3.9/site-packages/dateutil/tz/win.py
_settzkeyname" s
r c @ s6 e Zd ZdZeejZd
ddZ dd Z
dd Z d S ) r z}
Class for accessing ``tzres.dll``, which contains timezone name related
resources.
.. versionadded:: 2.5.0
tzres.dllc C s@ t d}tjtjtjt jf|j_|j| _t || _ || _
d S )Nuser32) ctypesZWinDLLr Z HINSTANCEZUINTLPWSTRZc_int LoadStringWargtypes_tzres tzres_loc)selfr r r r r __init__9 s
ztzres.__init__c C s< | }tt|tj}| | jj||d}|d| S )a
Load a timezone name from a DLL offset (integer).
>>> from dateutil.tzwin import tzres
>>> tzr = tzres()
>>> print(tzr.load_name(112))
'Eastern Standard Time'
:param offset:
A positive integer value referring to a string from the tzres dll.
.. note::
Offsets found in the registry are generally of the form
``@tzres.dll,-114``. The offset in this case is 114, not -114.
r N) p_wcharr castZbyrefr r r r Z_handle)r offsetresourceZlpBufferZncharr r r load_nameG s ztzres.load_namec C sH | ds|S |d}zt|d }W n tdY n0 | |S )a
Parse strings as returned from the Windows registry into the time zone
name as defined in the registry.
>>> from dateutil.tzwin import tzres
>>> tzr = tzres()
>>> print(tzr.name_from_string('@tzres.dll,-251'))
'Dateline Daylight Time'
>>> print(tzr.name_from_string('Eastern Standard Time'))
'Eastern Standard Time'
:param tzname_str:
A timezone name string as returned from a Windows registry key.
:return:
Returns the localized timezone string from tzres.dll if the string
is of the form `@tzres.dll,-offset`, else returns the input string.
@z,-r zMalformed timezone string.)
startswithsplitint
ValueErrorr$ )r Z
tzname_strZ name_spltr" r r r name_from_string^ s
ztzres.name_from_stringN)r ) __name__
__module__ __qualname____doc__r ZPOINTERr ZWCHARr r r$ r* r r r r r 0 s
r c @ sP e Zd ZdZdd Zdd Zedd Zdd Zd
d Z d d
Z
e dd Z dS ) tzwinbasezBtzinfo class based on win32's timezones available in the registry.c C s t dd S )Nz#tzwinbase is an abstract base class)NotImplementedErrorr r r r r s ztzwinbase.__init__c C s t |tstS | j|jko| j|jko| j|jko| j|jko| j|jko| j|jko| j |j ko| j
|j
ko| j |j ko| j |j ko| j
|j
ko| j|jkS r )
isinstancer/ NotImplemented _std_offset _dst_offset
_stddayofweek
_dstdayofweek_stdweeknumber_dstweeknumber_stdhour_dsthour
_stdminute
_dstminute _std_abbr _dst_abbr)r otherr r r __eq__ s2
ztzwinbase.__eq__c s~ t dt j\} t | t0 fddtt d D }W d n1 sR0 Y W d n1 sp0 Y |S )z4Return a list of all time zones known to the system.Nc s g | ]}t |qS r )r ZEnumKey).0itzkeyr r
s z"tzwinbase.list..r )r r r
r r range QueryInfoKey)r resultr rD r list s
Bztzwinbase.listc C s | j S )z;
Return the display name of the time zone.
)_displayr1 r r r display s ztzwinbase.displayc C sT | j s
dS t|| j| j| j| j| j}t|| j| j| j | j
| j }|| j 8 }||fS )a
For a given year, get the DST on and off transition times, expressed
always on the standard time side. For zones with no transitions, this
function returns ``None``.
:param year:
The year whose transitions you would like to query.
:return:
Returns a :class:`tuple` of :class:`datetime.datetime` objects,
``(dston, dstoff)`` for zones with an annual DST transition, or
``None`` for fixed offset zones.
N)
hasdstpicknthweekday _dstmonthr7 r; r= r9 _stdmonthr6 r: r< r8 _dst_base_offset)r yearZdstonZdstoffr r r transitions s
ztzwinbase.transitionsc C s
| j dkS )Nr )rO r1 r r r _get_hasdst s ztzwinbase._get_hasdstc C s | j S r )_dst_base_offset_r1 r r r rQ s ztzwinbase._dst_base_offsetN)
r+ r, r- r. r rA staticmethodrJ rL rS rT propertyrQ r r r r r/ } s
r/ c @ s( e Zd ZdZdd Zdd Zdd ZdS ) r a
Time zone object created from the zone info in the Windows registry
These are similar to :py:class:`dateutil.tz.tzrange` objects in that
the time zone data is provided in the format of a single offset rule
for either 0 or 2 time zone transitions per year.
:param: name
The name of a Windows time zone key, e.g. "Eastern Standard Time".
The full list of keys can be retrieved with :func:`tzwin.list`.
c C s> || _ td tjV}tdjt|d}t||}t|}W d n1 sR0 Y W d n1 sp0 Y |d | _ |d | _
|d | _ t
d|d }|d |d }||d
}tj|d | _tj|d | _|d d
\| _| _| _| _| _|dd \| _| _| _| _| _| j| j | _ | | _ d S )Nz {kn}\{name})knnameZStdZDltDisplayz=3l16hZTZIr r Zminutes ) _namer r r
r formatr r valuestodictr> r? rK structunpackdatetime timedeltar4 r5 rP r6 r8 r: r< rO r7 r9 r; r= rU rT rM ) r rY r tzkeynamerE keydicttup stdoffset dstoffsetr r r r s6 D
ztzwin.__init__c C s dt | j S )Nz tzwin(%s))reprra r1 r r r __repr__ s ztzwin.__repr__c C s | j | jffS r ) __class__ra r1 r r r
__reduce__ s ztzwin.__reduce__N)r+ r, r- r. r rn rp r r r r r s %r c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
S ) r a,
Class representing the local time zone information in the Windows registry
While :class:`dateutil.tz.tzlocal` makes system calls (via the :mod:`time`
module) to retrieve time zone information, ``tzwinlocal`` retrieves the
rules directly from the Windows registry and creates an object like
:class:`dateutil.tz.tzwin`.
Because Windows does not have an equivalent of :func:`time.tzset`, on
Windows, :class:`dateutil.tz.tzlocal` instances will always reflect the
time zone settings *at the time that the process was started*, meaning
changes to the machine's time zone settings during the run of a program
on Windows will **not** be reflected by :class:`dateutil.tz.tzlocal`.
Because ``tzwinlocal`` reads the registry directly, it is unaffected by
this issue.
c
C s t d t j}t |t}t|}W d n1 s:0 Y |d | _|d | _zVtdj t
| jd}t ||"}t|}|d | _ W d n1 s0 Y W n t y d | _ Y n0 W d n1 s0 Y |d |d }||d }t
j|d | _t
j|d | _td
|d } | d d
\| _| _| _| _| d | _td
|d } | d d
\| _| _| _| _| d | _ | j| j | _ | | _ d S )NZ StandardNameZ DaylightNamez {kn}\{sn})rX ZsnrZ ZBiasZ StandardBiasZ DaylightBiasr\ z=8hZ
StandardStartr r
Z
DaylightStart) r r r
r TZLOCALKEYNAMErc r> r? r rb r rK OSErrorrf rg r4 r5 rd re rP r8 r: r< r6 rO r9 r; r= r7 rU rT rM )
r r Z
tzlocalkeyri rh rE Z_keydictrk rl rj r r r r sD &
, *
ztzwinlocal.__init__c C s dS )Nz tzwinlocal()r r1 r r r rn B s ztzwinlocal.__repr__c C s dt | j S )Nztzwinlocal(%s))rm r> r1 r r r __str__E s ztzwinlocal.__str__c C s
| j dfS )Nr )ro r1 r r r rp I s ztzwinlocal.__reduce__N)r+ r, r- r. r rn rt rp r r r r r s
.r c C sT t | |d||}|j|| d d d}||d t }|j|krP|t8 }|S )z> dayofweek == 0 means Sunday, whichweek 5 means last instance r r
)Zday)rf replaceZ
isoweekdayONEWEEKmonth) rR rw Z dayofweekZhourZminuteZ whichweekfirstZ
weekdayoneZwdr r r rN M s
rN c C s i }t | d }d}t|D ]v}t | |\}}}|t jksH|t jkrZ|d@ r|d }n2|t jkr|dr|pvt }| |}|
d}|||< q |S )z0Convert a registry key's values to a dictionary.r Nl l z@tzres ) r rH rG Z EnumValueZ REG_DWORDZREG_DWORD_LITTLE_ENDIANZREG_SZr& r r* rstrip)keyZdoutsizeZtz_resrC Zkey_namevalueZdtyper r r rc [ s
rc ) r. rf rd Z six.movesr Zsixr r r r) ImportErrorZ_commonr __all__rg rv r r rr r r objectr r/ r r rN rc r r r r s.
MM9J