Ë
|
Yñúhõ ã óØ d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl
|
Z
|
ddl
|
m Z ddl m Z ddlmZmZ ddlmZmZ dd lmZ dd
|
lmZmZ dd lmZ dd lmZmZ dd l m Z ej< d« Z ej ddddd« Z e jC « Z" e
|
jF e« G d dejH « « Z% e%« Z& e
|
jF e« G d dejH « « Z' G d de« Z( G d de)« Z* G d de)« Z+ G d de« Z, G d d e« Z- e
|
jF e« G d d e-« « Z. G d d e)« Z/ G d! d"e« Z0 G d# d$e)« Z1ejd d%k7 r d&d'gZ3g d(¢Z4ng Z3g Z4d) Z5 e5« Z6[5d4d*Z7d4d+Z8d, Z9d- Z:ejv d.k\ rd/ Z<nd0 Z< dd1l=m>Z? y# e$ r dxZZY pw xY w# e$ r G d2 d3e)« Z?Y yw xY w)5a
|
This module offers timezone implementations subclassing the abstract
|
:py:class:`datetime.tzinfo` type. There are classes to handle tzfile format
|
files (usually are in :file:`/etc/localtime`, :file:`/usr/share/zoneinfo`,
|
etc), TZ environment string (in all known formats), given ranges (with help
|
from relative deltas), local machine timezone, fixed offset timezone, and UTC
|
timezone.
|
é N)Ú OrderedDict)Ú string_types)Ú_threadé )Útzname_in_python2Ú_tzinfo)Ú tzrangebaseÚenfold)Ú_validate_fromutc_inputs)Ú _TzSingletonÚ_TzOffsetFactory)Ú _TzStrFactory)ÚtzwinÚ
|
tzwinlocal)Úwarni² c óp e Zd ZdZd Zd Zed « Zd Ze d « Z
|
d Z dZ d Z d
|
Zej Zy) Útzutcaî
|
This is a tzinfo object that represents the UTC time zone.
|
|
**Examples:**
|
|
.. doctest::
|
|
>>> from datetime import *
|
>>> from dateutil.tz import *
|
|
>>> datetime.now()
|
datetime.datetime(2003, 9, 27, 9, 40, 1, 521290)
|
|
>>> datetime.now(tzutc())
|
datetime.datetime(2003, 9, 27, 12, 40, 12, 156379, tzinfo=tzutc())
|
|
>>> datetime.now(tzutc()).tzname()
|
'UTC'
|
|
.. versionchanged:: 2.7.0
|
``tzutc()`` is now a singleton, so the result of ``tzutc()`` will
|
always return the same object.
|
|
.. doctest::
|
|
>>> from dateutil.tz import tzutc, UTC
|
>>> tzutc() is tzutc()
|
True
|
>>> tzutc() is UTC
|
True
|
c ó t S ©N©ÚZERO©ÚselfÚdts úAH:\Change_password\venv_build\Lib\site-packages\dateutil/tz/tz.pyÚ utcoffsetztzutc.utcoffsetJ ó Ü ó c ó t S r r r s r Údstz tzutc.dstM r r c ó y)NÚUTC© r s r Útznamez tzutc.tznameP s àr c ó y)á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
|
Fr# r s r Ú is_ambiguousztzutc.is_ambiguousT s ð r c ó |S )z
|
Fast track version of fromutc() returns the original ``dt`` object for
|
any valid :py:class:`datetime.datetime` object.
|
r# r s r Úfromutcz tzutc.fromutcd s ð r c ó¨ t |t t f« st S t |t « xs% t |t « xr |j t
|
k( S r )Ú
|
isinstancer ÚtzoffsetÚNotImplementedÚ_offsetr ©r Úothers r Ú__eq__z tzutc.__eq__l sE Ü%¤%¬Ð!2Ô3Ü!Ð !ä5¤%Ó(ò HÜE¤8Ó,ÒF°· ± Ä$Ñ1Fð Ir Nc ó | |k( S r r# r/ s r Ú__ne__z tzutc.__ne__u ó ØEMÐ"Ð"r c ó4 d| j j z S ©Nz%s()©Ú __class__Ú__name__©r s r Ú__repr__ztzutc.__repr__x ó Ø×/Ñ/Ñ/Ð/r )r9 Ú
|
__module__Ú __qualname__Ú__doc__r r r r$ r' r r) r1 Ú__hash__r3 r; ÚobjectÚ
|
__reduce__r# r r r r ) sb ñ ò>òð ñó ðòð ñó ðòIð Hò#ò0ð ×"Ñ"Jr r c óv e Zd ZdZd Zd Zd Zed « Ze d « Z
|
d Z d Z d Z d
|
Zd Zej" Zy ) r, a1
|
A simple class for representing a fixed offset from UTC.
|
|
:param name:
|
The timezone name, to be returned when ``tzname()`` is called.
|
:param offset:
|
The time zone offset in seconds, or (since version 2.6.0, represented
|
as a :py:class:`datetime.timedelta` object).
|
c ó¦ || _ |j « }t j
|
t |« ¬« | _ y # t t f$ r Y 6w xY w©N©Úseconds)Ú_nameÚ total_secondsÚ TypeErrorÚAttributeErrorÚdatetimeÚ timedeltaÚ_get_supported_offsetr. )r ÚnameÚoffsets r Ú__init__ztzoffset.__init__ sO Ø
|
ð à×)Ñ)Ó+Fô ×)Ñ)Ô2GÈÓ2OÔP øô >Ð*ò Ù ð ús > ¾AÁAc ó | j S r ©r. r s r r ztzoffset.utcoffset s Ø||Ðr c ó t S r r r s r r z tzoffset.dst r r c ó | j S r )rH r s r r$ ztzoffset.tzname s àzzÐr c ó || j z S r rS r s r r) ztzoffset.fromutc¤ s àDLLÑ Ð r c ó y)a4
|
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
|
Fr# r s r r' ztzoffset.is_ambiguous¨ s ð r c ó` t |t « st S | j |j k( S r )r+ r, r- r. r/ s r r1 ztzoffset.__eq__¶ s% Ü%¤Ô*Ü!Ð !à||u}}Ñ,Ð,r Nc ó | |k( S r r# r/ s r r3 ztzoffset.__ne__¾ r4 r c ó¨ | j j dt | j « dt | j
|
j « « dS )Nú(ú, ú))r8 r9 ÚreprrH Úintr. rI r: s r r; ztzoffset.__repr__Á s< Ø #~~× 6Ó 6Ü # D§J¡JÕ /Ü " 4§<¡<×#=Ñ#=Ó#?Õ @ðBð Br )r9 r= r> r? rQ r r r r$ r r) r' r1 r@ r3 r; rA rB r# r r r, r, sh ñò Qò òð ñó ðð ñ!ó ð!ò ò -ð Hò#òBð
|
×"Ñ"Jr r, c ó e Zd ZdZ fdZd Zd Zed « Zd Z d Z
|
d dZ d Z d
|
Z d Zd Zej" Z xZS )ÚtzlocalzR
|
A :class:`tzinfo` subclass built around the ``time`` timezone functions.
|
c óÂ t t | « t j t
|
j ¬« | _ t
|
j r+t j t
|
j ¬« | _
|
n| j | _
|
| j | j z
|
| _ t | j « | _ t t
|
j « | _ y rE )Úsuperra rQ rL rM ÚtimeÚtimezoneÚ _std_offsetÚdaylightÚaltzoneÚ _dst_offsetÚ
|
_dst_savedÚboolÚ_hasdstÚtupler$ Ú_tznames)r r8 s r rQ ztzlocal.__init__Í s ø Ü gtÑ%Ô'ä#×-Ñ-´t·}±}°nÔEÔÜ ==Ü '× 1Ñ 1¼4¿<¹<¸-Ô HDÕ à #× /Ñ /DÔ à ×*Ñ*¨T×-=Ñ-=Ñ=ÜDOOÓ, Ü dkkÓ* r c ór | | j ry | j |« r | j S | j S r )rl Ú_isdstri rf r s r r ztzlocal.utcoffsetÚ s3 Ø :$,,Øà ;;r?Ø×#Ñ#Ð #à×#Ñ#Ð #r c ó | | j ry | j |« r| j | j z
|
S t S r )rl rp ri rf r r s r r z tzlocal.dstã s7 Ø :$,,Øà ;;r?Ø×#Ñ# d×&6Ñ&6Ñ6Ð 6äKr c ó> | j | j |« S r )rn rp r s r r$ ztzlocal.tznameì s à}}T[[¨_Ñ-Ð-r c óp | j |« }| xr! || j || j z
|
« k7 S )r& )Ú _naive_is_dstrj )r r Ú naive_dsts r r' ztzlocal.is_ambiguousð sA ð ×&Ñ& rÓ* Ø ò HØd× 0Ñ 0°°d·o±oÑ1EÓ FÑFð Ir c óx t |« }t j |t j z « j S r )Ú_datetime_to_timestamprd Ú localtimere Útm_isdst)r r Ú timestamps r rt ztzlocal._naive_is_dst s* Ü*¨2Ó. Ü~~i¬$¯-©-Ñ 7Ó8×AÑAÐAr c ó¨ | j sy| j |« }t |dd « }| j |« r|| j |« S y|S )NFÚfoldT)rl rt Úgetattrr' Ú_fold)r r Ú
|
fold_naiveÚdstvalr| s r rp ztzlocal._isdst s[ ð2 ||Øð ×#Ñ# BÓ'Ür6 4Ó(à × Ñ RÔ ØÐ Ø :: b>Ð)Ð)àà r c óÌ t |t « r4| j |j k( xr | j |j k( S t |t « r5| j
|
xr& | j d dv xr | j t k( S t |t « rF| j
|
xr7 | j d |j k( xr | j |j k( S t S )Nr > ÚGMTr" ) r+ ra rf ri r rl rn r r, rH r. r- r/ s r r1 ztzlocal.__eq__. sÔ Ü eWÔ %Ø×$Ñ$¨×(9Ñ(9Ñ9ò :Ø×$Ñ$¨×(9Ñ(9Ñ9ð ;ä uÔ %Ø Ð$ò -ØMM !Ñ$¨Ð6ò-à×$Ñ$¬Ñ,ð .ô xÔ (Ø Ð$ò 6ØMM !Ñ$¨¯ © Ñ3ò6à×$Ñ$¨¯ © Ñ5ð 7ô "Ð !r Nc ó | |k( S r r# r/ s r r3 ztzlocal.__ne__? r4 r c ó4 d| j j z S r6 r7 r: s r r; ztzlocal.__repr__B r< r )T)r9 r= r> r? rQ r r r r$ r' rt rp r1 r@ r3 r; rA rB Ú __classcell__©r8 s @r ra ra É s` ø ñô +ò$òð ñ.ó ð.òIò$Bó&òP "ð Hò#ò0ð ×"Ñ"Jr ra c ó< e Zd Zg d¢Zd Zd Zd ZdZd Zd Z d Z
|
y) Ú_ttinfo)rP ÚdeltaÚisdstÚabbrÚisstdÚisgmtÚ dstoffsetc ó@ | j D ] }t | |d « y r ©Ú __slots__Úsetattr)r Úattrs r rQ z_ttinfo.__init__L s! ØNNò &DÜ D$ Õ %ñ &r c óÚ g }| j D ]0 }t | |« }||j |dt |« « 2 | j j
|
ddj |« dS )Nú=r[ r\ r] )r r} Úappendr^ r8 r9 Újoin)r Úlr Úvalues r r; z_ttinfo.__repr__P s` Ø ØNNò 8DÜD $Ó'EØÑ Ø¢D¬$¨u¬+Ð6Õ7ð 8ð >>×2Ó2°D·I±I¸aµLÐAÐAr c ó¤ t |t « st S | j |j k( xr | j |j k( xr
| j
|
|j
|
k( xrj | j |j k( xrO | j |j k( xr4 | j |j k( xr | j |j k( S r )
|
r+ r r- rP r r r r r r r/ s r r1 z_ttinfo.__eq__X s Ü%¤Ô)Ü!Ð !à u||Ñ+ò 2Ø
|
|
ekkÑ)ò2à
|
|
ekkÑ)ò2ð UZZÑ'ò2ð
|
|
ekkÑ)ò 2ð
|
|
|
ekkÑ)ò 2ð %§/¡/Ñ1ð 3r Nc ó | |k( S r r# r/ s r r3 z_ttinfo.__ne__f r4 r c óL i }| j D ] }t | |d « ||< |S r )r r} ©r ÚstaterO s r Ú __getstate__z_ttinfo.__getstate__i s1 ØØNNò 4DÜ! $¨¨dÓ3E$Kð 4à r c óP | j D ] }||v st | ||| « y r r r s r Ú __setstate__z_ttinfo.__setstate__o s, ØNNò 1DØu}Üd E¨$¡KÕ0ñ 1r ) r9 r= r> r rQ r; r1 r@ r3 r r¡ r# r r r r H s/ ò0Iò&òBò
|
3ð Hò#òó 1r r c ó e Zd ZdZg d¢Zd Zy)Ú_tzfilezw
|
Lightweight class for holding the relevant transition and time zone
|
information read from binary tzfiles.
|
)Ú
|
trans_listÚtrans_list_utcÚ trans_idxÚ ttinfo_listÚ
|
ttinfo_stdÚ
|
ttinfo_dstÚ ttinfo_beforeÚ ttinfo_firstc ó` | j D ] }t | ||j |d « « ! y r )Úattrsr Úget)r Úkwargsr s r rQ z_tzfile.__init__} s, ØJJò 8DÜ D$ §
|
¡
|
¨4°Ó 6Õ 7ñ 8r N)r9 r= r> r? r rQ r# r r r£ r£ u s ñò JEó8r r£ c ó e Zd ZdZd fd Zd Zd ZddZd Zd Z d Z
|
dd
|
Z d Z d Z d Zed « Zd ZdZd Zd Zd Zd Z xZS )Útzfileaè
|
This is a ``tzinfo`` subclass that allows one to use the ``tzfile(5)``
|
format timezone files to extract current and historical zone information.
|
|
:param fileobj:
|
This can be an opened file stream or a file name that the time zone
|
information can be read from.
|
|
:param filename:
|
This is an optional parameter specifying the source of the time zone
|
information in the event that ``fileobj`` is a file object. If omitted
|
and ``fileobj`` is a file stream, this parameter will be set either to
|
``fileobj``'s ``name`` attribute or to ``repr(fileobj)``.
|
|
See `Sources for Time Zone and Daylight Saving Time Data
|
<https://data.iana.org/time-zones/tz-link.html>`_ for more information.
|
Time zone files can be compiled from the `IANA Time Zone database files
|
<https://www.iana.org/time-zones>`_ with the `zic time zone compiler
|
<https://www.freebsd.org/cgi/man.cgi?query=zic&sektion=8>`_
|
|
.. note::
|
|
Only construct a ``tzfile`` directly if you have a specific timezone
|
file on disk that you want to read into a Python ``tzinfo`` object.
|
If you want to get a ``tzfile`` representing a specific IANA zone,
|
(e.g. ``'America/New_York'``), you should call
|
:func:`dateutil.tz.gettz` with the zone identifier.
|
|
|
**Examples:**
|
|
Using the US Eastern time zone as an example, we can see that a ``tzfile``
|
provides time zone information for the standard Daylight Saving offsets:
|
|
.. testsetup:: tzfile
|
|
from dateutil.tz import gettz
|
from datetime import datetime
|
|
.. doctest:: tzfile
|
|
>>> NYC = gettz('America/New_York')
|
>>> NYC
|
tzfile('/usr/share/zoneinfo/America/New_York')
|
|
>>> print(datetime(2016, 1, 3, tzinfo=NYC)) # EST
|
2016-01-03 00:00:00-05:00
|
|
>>> print(datetime(2016, 7, 7, tzinfo=NYC)) # EDT
|
2016-07-07 00:00:00-04:00
|
|
|
The ``tzfile`` structure contains a fully history of the time zone,
|
so historical dates will also have the right offsets. For example, before
|
the adoption of the UTC standards, New York used local solar mean time:
|
|
.. doctest:: tzfile
|
|
>>> print(datetime(1901, 4, 12, tzinfo=NYC)) # LMT
|
1901-04-12 00:00:00-04:56
|
|
And during World War II, New York was on "Eastern War Time", which was a
|
state of permanent daylight saving time:
|
|
.. doctest:: tzfile
|
|
>>> print(datetime(1944, 2, 7, tzinfo=NYC)) # EWT
|
1944-02-07 00:00:00-04:00
|
|
Nc ó| t t | « d}t |t « r|| _ t |d« }d}n8||| _ n.t |d« r|j | _ nt |« | _ |;|s t |« }|5 }| j |« }d d d « | j « y y # 1 sw Y xY w)NFÚrbTrO ) rc r± rQ r+ r Ú _filenameÚopenÚhasattrrO r^ Ú _nullcontextÚ _read_tzfileÚ _set_tzdata)r ÚfileobjÚfilenameÚfile_opened_hereÚ file_streamÚtzobjr8 s r rQ ztzfile.__init__Ê s¸ ø Ü fdÑ$Ô&à ÐÜ g|Ô ,Ø $DNÜ7 DÓ)GØ #Ñ Ø Ð !Ø %DNÜ WfÔ %Ø $\\DNä ! ']DNà Ð Ù#Ü& wÓ/àð 7KØ ×)Ñ)¨+Ó6÷ 7ð × Ñ UÕ #ð ÷ 7ð 7ús ÂB2Â2B;c ób t j D ] }t | d|z t ||« « y)z= Set the time zone data of this object from a _tzfile object Ú_N)r£ r r r} )r r¾ r s r r¹ ztzfile._set_tzdataâ s. ô MMò <DÜ D# *¤g¨e°TÓ&:Õ ;ñ <r c ó4
|
t « }|j d« j « dk7 r t d« |j d« t j
|
d|j d« « \ }}}}}}|r:t t j
|
d|z |j |dz « « « |_ ng |_ |r.t j
|
d|z |j |« « |_ ng |_ g } t |« D ]6 }
|
| j t j
|
d |j d
|
« « « 8 |j |« j « } |r#|j |d z t j « |r(t j
|
d |z |j |« « } |r(t j
|
d |z |j |« « } g |_ t |« D ]À }
|
| |
|
\ }}}t |« }t! « }||_ t% j& d « |_ t% j& |¬« |_ ||_ | || j/ d|« |_ ||
|
kD xr |
|
d k7 |_ ||
|
kD xr |
|
d k7 |_ |j j |« Â |j D cg c] }|j | c}|_ d |_ d |_ d |_ |j r |j s |j d x|_ |_ nát |dz
|
dd« D ]k }
|
|j |
|
}|j6 s|j, s||_ n |j8 s|j, r||_ |j6 s^|j8 sk n* |j8 r |j6 s|j8 |_ |j D ] }|j, r||_ n |j d |_ d }d }d }d }g |_ tA |j « D ]¥ \ }
|
}|j" }d }|6|j, r*|s||z
|
}|s|r|}t% j& |¬« |_ |}||z
|
}|}|||k7 r|j, |k7 r|}|j, }|}|}|j> j |j |
|
|z « § tC |j « |_ tC |j> « |_ tC |j « |_ |S c c}w )Né ÚTZifzmagic not foundé z>6lé z>%dlz>%dBz>lbbé é z>%dbr rF ú r éÿÿÿÿ)"r£ ÚreadÚdecodeÚ
|
ValueErrorÚstructÚunpackÚlistr¥ r¦ Úranger ÚseekÚosÚSEEK_CURr§ rN r rP rL rM r r r Úfindr r r r¨ r© rª r« r¤ Ú enumeraterm )r rº ÚoutÚ
|
ttisgmtcntÚ
|
ttisstdcntÚleapcntÚtimecntÚtypecntÚcharcntÚttinfoÚir r r Úgmtoffr ÚabbrindÚttiÚidxÚlastdstÚ
|
lastoffsetÚ lastdstoffsetÚlastbaseoffsetrP r Ú
|
baseoffsetÚ
|
adjustments r r¸ ztzfile._read_tzfileè s¬ Üið <<?× !Ñ !Ó # vÒ -Ü Ð .Ó/Ð /à RÔô2 MM% § ¡ ¨bÓ!1Ó 2ñ/
|
à ð ð ð ð ð ñ Ü!%¤f§m¡m°F¸WÑ4DØ4;·L±LÀÈÁÓ4Kó'Mó "NCÕ ð "$CÔ ñ Ü "MM¨&°7Ñ*:Ø*1¯,©,°wÓ*?ó ACMð CMð äw ò BAØ MM&--¨°· ± ¸Q³Ó@Õ Að Bð ||GÓ$×+Ñ+Ó-ñ Ø LL 1¤b§k¡kÔ 2ñ ÜMM &¨:Ñ"5Ø")§,¡,¨zÓ":ó<Eñ ÜMM &¨:Ñ"5Ø")§,¡,¨zÓ":ó<Eð Üw ò (AØ%+¨A¡YÑ "FE7Ü*¨6Ó2FÜ)CØ CJÜ $× .Ñ .¨qÓ 1CMÜ ×*Ñ*°6Ô:CIØ CIØG D§I¡I¨f°gÓ$>Ð?CHØ# a Ò9¨E°!©H¸©MCIØ# a Ò9¨E°!©H¸©MCIØ OO× "Ñ " 3Õ 'ð (ð :=¿ ¹ ÖG°# ¨Ó-ÒG ð Ø Ø ÔØ ??Ø×%Ò%Ø47·O±OÀAÑ4FÐF Õ!1ä w qy¨"¨bÓ1ò 8AØ --¨Ñ*CØ >>°#·)²)Ø),Ø ^^°· ² Ø),à~~¨#¯.«.Ù ð 8ð ~~¨c¯nªnØ),¯ © à ??ò ;CØ 99Ø,/Ô)Ù ð;ð
|
),¯©¸Ñ(:CÔ%ð Ø
|
Ø Ø Øä § ¡ Ó.ò FFAsØZZFØIàÐ"Ø99Ù"Ø$*¨ZÑ$7 á$© Ø$1 ä$,×$6Ñ$6¸yÔ$ICMØ$-Mð )Ñ+JØ#JØ Ð*¨z¸^Ò/KØ WÒ,à +
|
àiiGØ JØ 'Nà NN× !Ñ ! #×"4Ñ"4°QÑ"7¸*Ñ"DÕ Eð? FôB cmmÓ, Ü s~~Ó.Ü " 3×#5Ñ#5Ó 6Ôà
|
ùòg Hs Ê0Tc ó | j sy t |« }|r | j n | j }t j ||« }|dz
|
S )Nr )Ú _trans_listrw Ú_trans_list_utcÚbisectÚ bisect_right)r r Úin_utcrz r¤ râ s r Ú_find_last_transitionz tzfile._find_last_transitionÈ sL à× Ò Øä*¨2Ó. ñ .4T×)Ò)¸×9IÑ9I
|
Ü×!Ñ! *¨iÓ8ð Qwr c ó ||dz t | j « k\ r | j S |dk r | j S | j | S )Nr r )Úlenrê Ú _ttinfo_stdÚ_ttinfo_beforeÚ
|
_trans_idx)r râ s r Ú _get_ttinfoztzfile._get_ttinfo× sM à ;3 7¤s¨4×+;Ñ+;Ó'<Ò<Ø×#Ñ#Ð #ð 7Ø×&Ñ&Ð &àsÑ#Ð#r c óF | j |« }| j |« S r )Ú_resolve_ambiguous_timerõ )r r râ s r Ú _find_ttinfoztzfile._find_ttinfoâ s# Ø×*Ñ*¨2Ó.à× Ñ Ó$Ð$r c ó^ t |t j « s t d« |j | ur t d« | j |d¬« }| j |« }|t j |j ¬« z }| j ||¬« }t |t |« ¬« S )a
|
The ``tzfile`` implementation of :py:func:`datetime.tzinfo.fromutc`.
|
|
:param dt:
|
A :py:class:`datetime.datetime` object.
|
|
:raises TypeError:
|
Raised if ``dt`` is not a :py:class:`datetime.datetime` object.
|
|
:raises ValueError:
|
Raised if this is called with a ``dt`` which does not have this
|
``tzinfo`` attached.
|
|
:return:
|
Returns a :py:class:`datetime.datetime` object representing the
|
wall time in ``self``'s time zone.
|
z&fromutc() requires a datetime argumentzdt.tzinfo is not selfT)rî rF )râ ©r| ) r+ rL rJ ÚtzinforÌ rï rõ rM rP r' r
|
r_ )r r râ rá Údt_outr| s r r) ztzfile.fromutcç s ô( "h× /Ñ /Ô0ÜÐ DÓEÐ Eà 99DÑ Ü Ð 4Ó5Ð 5ð ×(Ñ(¨°DÐ(Ó9Ø× Ñ sÓ#àh×(Ñ(°·±Ô<Ñ<à× Ñ ¨SÐ Ó1äf¤3 t£9Ô-Ð-r c óô || j |« }t |« }| j |« }||dk ry| j |dz
|
« j |j z
|
}| j | }|||z k S )r& r Fr )rï rw rõ rP rê )r r râ rz rá ÚodÚtts r r' ztzfile.is_ambiguous s
ð ;Ø×,Ñ,¨RÓ0Cô +¨2Ó. Ø× Ñ sÓ#à ;# (Øà × Ñ c AgÓ &× -Ñ -°·
|
±
|
Ñ :Ø × Ñ cÑ "à2 7Ñ"Ð"r c ó¢ | j |« }| j |« }||dk( r|S t | xr | j ||« « }||z
|
S )Nr )rï r~ r_ r' )r r râ r~ Ú
|
idx_offsets r r÷ z tzfile._resolve_ambiguous_time( s\ Ø×(Ñ(¨Ó,ð
|
|
2Ø ;# (ØJô UÒA t×'8Ñ'8¸¸SÓ'AÓB
|
àZÑ Ð r c ób |y | j st S | j |« j S r )rò r rø r r s r r ztzfile.utcoffset5 s/ Ø :Øà× Ò ÜKà× Ñ Ó$×*Ñ*Ð*r c ó |y | j st S | j |« }|j st S |j S r )Ú _ttinfo_dstr rø r r )r r rá s r r z
|
tzfile.dst> s@ Ø :Øà× Ò ÜKà× Ñ Ó#àyyÜKð }}Ð r c óV | j r|y | j |« j S r )rò rø r r s r r$ z tzfile.tznameN s) à× Ò 2 :ØØ× Ñ Ó$×)Ñ)Ð)r c óÌ t |t « st S | j |j k( xr4 | j |j k( xr | j
|
|j
|
k( S r )r+ r± r- rê rô Ú _ttinfo_listr/ s r r1 z tzfile.__eq__T s[ Ü%¤Ô(Ü!Ð !Ø× Ñ E×$5Ñ$5Ñ5ò 8Ø 5×#3Ñ#3Ñ3ò8à×!Ñ! U×%7Ñ%7Ñ7ð 9r c ó | |k( S r r# r/ s r r3 z tzfile.__ne__] r4 r c ó` | j j dt | j « dS ©Nr[ r] )r8 r9 r^ r´ r: s r r; ztzfile.__repr__` s Ø >>×2Ó2´D¸¿ ¹ Õ4HÐIÐIr c ó$ | j d « S r )Ú __reduce_ex__r: s r rB ztzfile.__reduce__c s Ø×!Ñ! $Ó'Ð'r c óL | j d | j f| j fS r )r8 r´ Ú__dict__)r Úprotocols r r ztzfile.__reduce_ex__f s Ø t§~¡~Ð 6¸¿ ¹ ÐFÐFr r ©F)r9 r= r> r? rQ r¹ r¸ rï rõ rø r) r' r÷ r r r r$ r1 r@ r3 r; rB r r
r s @r r± r± sz ø ñEõN$ò0<ò ^ó@ ò $ò%ò
|
".óH#ò: ò+ò ð ñ*ó ð*ò
|
9ð Hò#òJò(öGr r± c ó: e Zd ZdZ ddZd Zd Zed « Zy)Útzrangea[
|
The ``tzrange`` object is a time zone specified by a set of offsets and
|
abbreviations, equivalent to the way the ``TZ`` variable can be specified
|
in POSIX-like systems, but using Python delta objects to specify DST
|
start, end and offsets.
|
|
:param stdabbr:
|
The abbreviation for standard time (e.g. ``'EST'``).
|
|
:param stdoffset:
|
An integer or :class:`datetime.timedelta` object or equivalent
|
specifying the base offset from UTC.
|
|
If unspecified, +00:00 is used.
|
|
:param dstabbr:
|
The abbreviation for DST / "Summer" time (e.g. ``'EDT'``).
|
|
If specified, with no other DST information, DST is assumed to occur
|
and the default behavior or ``dstoffset``, ``start`` and ``end`` is
|
used. If unspecified and no other DST information is specified, it
|
is assumed that this zone has no DST.
|
|
If this is unspecified and other DST information is *is* specified,
|
DST occurs in the zone but the time zone abbreviation is left
|
unchanged.
|
|
:param dstoffset:
|
A an integer or :class:`datetime.timedelta` object or equivalent
|
specifying the UTC offset during DST. If unspecified and any other DST
|
information is specified, it is assumed to be the STD offset +1 hour.
|
|
:param start:
|
A :class:`relativedelta.relativedelta` object or equivalent specifying
|
the time and time of year that daylight savings time starts. To
|
specify, for example, that DST starts at 2AM on the 2nd Sunday in
|
March, pass:
|
|
``relativedelta(hours=2, month=3, day=1, weekday=SU(+2))``
|
|
If unspecified and any other DST information is specified, the default
|
value is 2 AM on the first Sunday in April.
|
|
:param end:
|
A :class:`relativedelta.relativedelta` object or equivalent
|
representing the time and time of year that daylight savings time
|
ends, with the same specification method as in ``start``. One note is
|
that this should point to the first time in the *standard* zone, so if
|
a transition occurs at 2AM in the DST zone and the clocks are set back
|
1 hour to 1AM, set the ``hours`` parameter to +1.
|
|
|
**Examples:**
|
|
.. testsetup:: tzrange
|
|
from dateutil.tz import tzrange, tzstr
|
|
.. doctest:: tzrange
|
|
>>> tzstr('EST5EDT') == tzrange("EST", -18000, "EDT")
|
True
|
|
>>> from dateutil.relativedelta import *
|
>>> range1 = tzrange("EST", -18000, "EDT")
|
>>> range2 = tzrange("EST", -18000, "EDT", -14400,
|
... relativedelta(hours=+2, month=4, day=1,
|
... weekday=SU(+1)),
|
... relativedelta(hours=+1, month=10, day=31,
|
... weekday=SU(-1)))
|
>>> tzstr('EST5EDT') == range1 == range2
|
True
|
|
Nc ó* ddl ma || _ || _ |j « } |j « }| t j |¬« | _ n t | _ | t j |¬« | _ n8|r+|)| j t j d¬« z | _ n t | _ |r4|2t j dddt j d« ¬« | _ n|| _ |r4|2t j dd d
|
t j d « ¬« | _ n|| _ | j | j z
|
| _ t! | j « | _ y # t
|
t f$ r Y Uw xY w# t
|
t f$ r Y Zw xY w) Nr ©Ú relativedeltarF r ©Úhoursé r )r ÚmonthÚdayÚweekdayé
|
é rÉ )Údateutilr Ú _std_abbrÚ _dst_abbrrI rJ rK rL rM rf r ri ÚSUÚ _start_deltaÚ
|
_end_deltaÚ_dst_base_offset_rk Úhasdst)r ÚstdabbrÚ stdoffsetÚdstabbrr ÚstartÚends r rQ ztzrange.__init__µ s| õ
|
+à Ø ð Ø!×/Ñ/Ó1Ið Ø!×/Ñ/Ó1Ið Ð Ü '× 1Ñ 1¸)Ô DDÕ ä #DÔ à Ð Ü '× 1Ñ 1¸)Ô DDÕ Ù Ð.Ø #× /Ñ /´(×2DÑ2DÈ2Ô2NÑ NDÕ ä #DÔ á u}Ü -× ;Ñ ;Ø q´-×2BÑ2BÀ2Ó2Fð !<ó !HDÕ ð !&DÔ á s{Ü +× 9Ñ 9Ø ¨´M×4DÑ4DÀRÓ4Hð :ó JDOð "DOà!%×!1Ñ!1°D×4DÑ4DÑ!DÔ Ü4×,Ñ,Ó- øôC >Ð*ò Ú ð ûô
|
>Ð*ò Ú ð ús" E) §E? Å)E<Å;E<Å?FÆFc ó | j syt j |dd« }|| j z }|| j z }||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.
|
Nr )r% rL r" r# )r ÚyearÚ base_yearr) r* s r Ú transitionsztzrange.transitionsä sJ ð {{Øä ×%Ñ% d¨A¨qÓ1 àD× -Ñ -Ñ-Ø$//Ñ)às|Ðr c ón t |t « st S | j |j k( xr
| j |j k( xrj | j
|
|j
|
k( xrO | j |j k( xr4 | j |j k( xr | j |j k( S r ) r+ r r- r r rf ri r" r# r/ s r r1 ztzrange.__eq__ü s¤ Ü%¤Ô)Ü!Ð !à %§/¡/Ñ1ò 4Ø %§/¡/Ñ1ò4à× Ñ E×$5Ñ$5Ñ5ò4ð × Ñ E×$5Ñ$5Ñ5ò4ð ×!Ñ! U×%7Ñ%7Ñ7ò 4ð
|
5×#3Ñ#3Ñ3ð 5r c ó | j S r )r$ r: s r Ú_dst_base_offsetztzrange._dst_base_offset s à×%Ñ%Ð%r )NNNNN) r9 r= r> r? rQ r. r1 Úpropertyr1 r# r r r r j s8 ñIðT +/Ø)-Ø!%ó-.ò^ ò0 5ð ñ&ó ñ&r r c ó& e Zd ZdZddZddZd Zy)Útzstraº
|
``tzstr`` objects are time zone objects specified by a time-zone string as
|
it would be passed to a ``TZ`` variable on POSIX-style systems (see
|
the `GNU C Library: TZ Variable`_ for more details).
|
|
There is one notable exception, which is that POSIX-style time zones use an
|
inverted offset format, so normally ``GMT+3`` would be parsed as an offset
|
3 hours *behind* GMT. The ``tzstr`` time zone object will parse this as an
|
offset 3 hours *ahead* of GMT. If you would like to maintain the POSIX
|
behavior, pass a ``True`` value to ``posix_offset``.
|
|
The :class:`tzrange` object provides the same functionality, but is
|
specified using :class:`relativedelta.relativedelta` objects. rather than
|
strings.
|
|
:param s:
|
A time zone string in ``TZ`` variable format. This can be a
|
:class:`bytes` (2.x: :class:`str`), :class:`str` (2.x:
|
:class:`unicode`) or a stream emitting unicode characters
|
(e.g. :class:`StringIO`).
|
|
:param posix_offset:
|
Optional. If set to ``True``, interpret strings such as ``GMT+3`` or
|
``UTC+3`` as being 3 hours *behind* UTC rather than ahead, per the
|
POSIX standard.
|
|
.. caution::
|
|
Prior to version 2.7.0, this function also supported time zones
|
in the format:
|
|
* ``EST5EDT,4,0,6,7200,10,0,26,7200,3600``
|
* ``EST5EDT,4,1,0,7200,10,-1,0,7200,3600``
|
|
This format is non-standard and has been deprecated; this function
|
will raise a :class:`DeprecatedTZFormatWarning` until
|
support is removed in a future version.
|
|
.. _`GNU C Library: TZ Variable`:
|
https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html
|
c óR ddl ma || _ t j |« }| |j
|
r t d« |j dv r|s|xj dz c_ t j | |j |j |j |j dd¬« |j sd | _ d | _ nN| j |j « | _ | j r"| j |j" d¬ « | _ t% | j « | _ y )
|
Nr )Ú_parserzunknown string format©r r" rÉ F)r) r* r )Úisend)Údateutil.parserr6 ÚparserÚ_sÚ_parsetzÚany_unused_tokensrÌ r& r' r rQ r( r r" r# Ú_deltar) r* rk r% )r ÚsÚ posix_offsetÚress r rQ ztzstr.__init__7 sæ å5àäooaÓ Ø ;#×/Ò/Ü Ð 4Ó5Ð 5ð ;;.Ñ (± Ø MMRÑ Mô
|
×Ñs{{¨C¯M©MØ c§m¡mØ $¨%ð ô 1ð {{Ø $DÔ Ø "DOà $§ ¡ ¨C¯I©IÓ 6DÔ Ø× Ò Ø"&§+¡+¨c¯g©g¸Q +Ó"?ä4×,Ñ,Ó- r c óú ddl m} i }|j {|j |d< |j D|j |j |j « |d< |j dkD rd|d< nYd|d< nS|j
|
rG|j
|
|d< n7|j |j |d< n|j |j |d < |s?|s d
|
|d< d|d< |j d« |d< n d |d< d|d< |j d « |d< |j |j |d < nd|d < |r@| j | j z
|
}|d xx |j |j dz z z cc< |j di |¤S )Nr r r r r r r ÚyeardayÚ nlyeardayr r rÉ rG i iQ r# )r r r r Úweekr ÚydayÚjydayr! rd ri rf rG Údays)r Úxr8 r r¯ r s r r> z tzstr._deltaW sx Ý*ØØ 77Ð Ø ggF7OØyyÐ$Ø$1×$9Ñ$9¸!¿)¹)ÀQÇVÁVÓ$LyÑ!Ø66A:Ø$%F5Mà$&F5MØØ !§¡u Ø VVÐ Ø !§¡F9Ò Ø WWÐ Ø"#§'¡'F;Ñ Ùñ Ø"#wØ !u Ø$1×$4Ñ$4°RÓ$8yÒ!à"$wØ "u Ø$1×$4Ñ$4°RÓ$8yÑ!Ø 66Ð Ø !§¡F9Ò ð !%F9Ñ Ù ð ×$Ñ$ t×'7Ñ'7Ñ7EØ 9Ó § ¡ °·±¸eÑ1CÑ!CÑ CÓ Ø*}×*Ñ*Ñ4¨VÑ4Ð4r c ó` | j j dt | j « dS r
|
©r8 r9 r^ r; r: s r r; ztzstr.__repr__ ó Ø >>×2Ó2´D¸¿¹µMÐBÐBr Nr )r )r9 r= r> r? rQ r> r; r# r r r4 r4 s ñ(óR .ó@'5óRCr r4 c ó e Zd Z ddZy)Ú_tzicalvtzcompNc óÖ t j |¬« | _ t j |¬« | _ | j | j z
|
| _ || _ || _ || _ y rE )rL rM Ú tzoffsetfromÚ
|
tzoffsettoÚ tzoffsetdiffr r$ Úrrule)r rP rQ r r$ rS s r rQ z_tzicalvtzcomp.__init__
sS ä $× .Ñ .°|Ô DÔÜ"×,Ñ,°ZÔ@Ø OO¨d×.?Ñ.?Ñ ?ÔØ
|
Ø Ø
|
r )NN)r9 r= r> rQ r# r r rN rN s
|
à$(ôr rN c óh e Zd Zg f fd Zd Zd Zd Zd Zed « Z d Z
|
e j Z xZ S )Ú
|
_tzicalvtzc ó t t | « || _ || _ g | _ g | _ t j « | _ y r )
|
rc rU rQ Ú_tzidÚ_compsÚ
|
_cachedateÚ
|
_cachecompr Ú allocate_lockÚ _cache_lock)r ÚtzidÚcompsr8 s r rQ z_tzicalvtz.__init__ s= ø Ü j$Ñ(Ô*à
|
Ø Ø Ø Ü"×0Ñ0Ó2Õr c óz t | j « dk( r| j d S |j d ¬« } | j 5 | j | j
|
j || j |« f« cd d d « S # 1 sw Y nxY wn# t $ r Y nw xY wd }d }| j D ]# }| j ||« }|s|r||k s |}|}% |s&| j D ] }|j r|} n d }| j 5 | j
|
j d|| j |« f« | j j d|« t | j
|
« dkD r4| j
|
j « | j j « d d d « |S # 1 sw Y |S xY w)Nr r ©rû r ) rñ rX Úreplacer\ rZ rY Úindexr~ rÌ Ú _find_compdtr ÚinsertÚpop)r r Ú
|
lastcompdtÚlastcompÚcompÚcompdts r Ú
|
_find_compz_tzicalvtz._find_comp s¢ Ü t{{Ó qÒ Ø;;q>Ð !à ZZtZÓ $ð Ø×!Ñ!ñ +Ø t§¡×'<Ñ'<Ø B Ð(ó(*ñ +÷ +÷ +ò +úð +øô ò Ù ð úð
|
ØàKKò DØ×&Ñ& t¨RÓ0Fâz¨Z¸&Ó-@Ø #
|
Ø ð ñ ð
|
ò #ØzzØ #HÙð #ð
|
7à × Ñ ñ &Ø OO× "Ñ " 1 r¨4¯:©:°b«>Ð&:Ô ;Ø OO× "Ñ " 1 hÔ /ä4??Ó# bÒ(Ø×#Ñ#Ô%Ø×#Ñ#Ô%÷ &ð ÷ &ð ús6 » B Á9B
|
 B Â
|
BÂB  B#Â"B#ÄBF0Æ0F:c ó¦ |j t k r | j |« r||j z }|j j |d¬« }|S )NT)Úinc)rR r r~ rS Úbefore)r rh r ri s r rc z_tzicalvtz._find_compdtÆ sH Ø × Ñ tÒ #¨¯
|
©
|
°2¬Ø $×#Ñ#Ñ #Bà×"Ñ" 2¨4Ð"Ó0à r c ó> |y | j |« j S r )rj rQ r s r r z_tzicalvtz.utcoffsetÎ s Ø :ØàrÓ"×-Ñ-Ð-r c ó` | j |« }|j r |j S t S r )rj r rR r )r r rh s r r z_tzicalvtz.dstÔ s( ØrÓ"Ø ::Ø×$Ñ$Ð $äKr c ó8 | j |« j S r )rj r$ r s r r$ z_tzicalvtz.tznameÛ s àrÓ"×)Ñ)Ð)r c ó2 dt | j « z S )Nz<tzicalvtz %s>)r^ rW r: s r r; z_tzicalvtz.__repr__ß s Ø ¤$ t§z¡zÓ"2Ñ2Ð2r )r9 r= r> rQ rj rc r r r r$ r; rA rB r
r s @r rU rU sF ø Ø#%õ 3ò+òZò.ò ð ñ*ó ð*ò3ð ×"Ñ"Jr rU c ó6 e Zd ZdZd Zd Zd dZd Zd Zd Z y)
|
Útzicala[
|
This object is designed to parse an iCalendar-style ``VTIMEZONE`` structure
|
as set out in `RFC 5545`_ Section 4.6.5 into one or more `tzinfo` objects.
|
|
:param `fileobj`:
|
A file or stream in iCalendar format, which should be UTF-8 encoded
|
with CRLF endings.
|
|
.. _`RFC 5545`: https://tools.ietf.org/html/rfc5545
|
c ó ddl ma t |t « r|| _ t |d« }n&t |dt |« « | _ t |« }i | _ |5 }| j |j « « d d d « y # 1 sw Y y xY w)Nr )rS ÚrrO ) r rS r+ r r; rµ r} r^ r· Ú_vtzÚ
|
_parse_rfcrÊ )r rº Úfobjs r rQ ztzical.__init__ð ss å"ä g|Ô ,Ø DGä7 CÓ(Gä g v¬t°G«}Ó=DGÜ" 7Ó+Gà à ð )Ø OODIIKÔ (÷ )÷ )ñ )ús Á BÂB c óH t | j j « « S )z?
|
Retrieves the available time zones as a list.
|
)rÏ rv Úkeysr: s r rz z tzical.keys s ô DIINNÓ$Ó%Ð%r Nc ó |dt | j « dk( r t d« t | j « dkD r t d« t t | j « « }| j j |« S )a
|
Retrieve a :py:class:`datetime.tzinfo` object by its ``tzid``.
|
|
:param tzid:
|
If there is exactly one time zone available, omitting ``tzid``
|
or passing :py:const:`None` value returns it. Otherwise a valid
|
key (which can be retrieved from :func:`keys`) is required.
|
|
:raises ValueError:
|
Raised if ``tzid`` is not specified but there are either more
|
or fewer than 1 zone defined.
|
|
:returns:
|
Returns either a :py:class:`datetime.tzinfo` object representing
|
the relevant time zone or :py:const:`None` if the ``tzid`` was
|
not found.
|
r zno timezones definedr z more than one timezone available)rñ rv rÌ ÚnextÚiterr® )r r] s r r® z
|
tzical.get sf ð$ <Ü499~ Ò"Ü Ð!7Ó8Ð8ÜTYY !Ò#Ü Ð!CÓDÐDÜTYYÓ(Dàyy}}TÓ"Ð"r c óz |j « }|s t d« |d dv rd|d dk( }|dd }nd}t |« dk( r&t |d d « d z t |dd « d
|
z z |z S t |« d k( r5t |d d « d z t |dd « d
|
z z t |dd « z |z S t d |z « ) Nz empty offsetr )ú+ú-)rÉ r r r r r i é< rÆ zinvalid offset: )ÚstriprÌ rñ r_ )r r? Úsignals r Ú _parse_offsetztzical._parse_offset" sÚ Ø GGIÙÜ ^Ó,Ð ,Ø Q4:Ñ Ø a d ckÑ*FØ!"AàFÜ q6Q;Ü"1J Ñ%¬¨A¨a¨b¨E«
|
°R©Ñ7¸6ÑAÐ AÜ Vq[Ü"1J Ñ%¬¨A¨a°¨F« °bÑ(8Ñ8¼3¸qÀÀ¸u»:ÑEÈÑOÐ Oä Ð /°!Ñ 3Ó4Ð 4r c ó |j « }|s t d« d}|t |« k rQ|| j « }|s||= n)|dkD r |d dk( r||dz
|
xx |dd z cc< ||= n|dz }|t |« k rQd }g }d}d }|D ]t }|s|j dd« \ } }
|
| j d« } | s t d« | d j « } | dd } |r | d k( r |
|
d
|
v rnt d |
|
z « |
|
}d} d } d }g }d }z| d k( rØ|
|
d k( rF|rt d|z « |s t d« |s t d« t ||« | j |< d}Ê|
|
|k( rz s t d« t d« t d« d }r(t j dj |« ddd¬« }t | ||dk( |« }|j |« d }It d|
|
z « |rØ| dk( r1| D ] }|dk7 s d|z }t |« j |« d} | dv rj |« ¦| d k( r*| rt d | d | d d« | j |
|
« } Õ| d k( r&| rt d | d z « | j |
|
« } | d!k( r| rt d"| d z « |
|
} | d#k( r#t d$| z « | d%k( r| rt d&| d z « |
|
}M| d'v rSt d$| z « | d k( sh|
|
d k( sod }g }d}w y )(Nz empty stringr ú r Fú:ú;zempty property nameÚBEGIN)ÚSTANDARDÚDAYLIGHTzunknown component: ÚENDÚ VTIMEZONEzcomponent not closed: zmandatory TZID not foundz at least one component is neededzmandatory DTSTART not foundz mandatory TZOFFSETFROM not foundú
|
T)Ú
|
compatibleÚignoretzÚcacher zinvalid component end: ÚDTSTARTzVALUE=DATE-TIMEz(Unsupported DTSTART param in VTIMEZONE: )ÚRRULEÚRDATEÚEXRULEÚEXDATEÚ TZOFFSETFROMz unsupported z parm: Ú
|
TZOFFSETTOz unsupported TZOFFSETTO parm: ÚTZNAMEzunsupported TZNAME parm: ÚCOMMENTzunsupported property: ÚTZIDzunsupported TZID parm: )ÚTZURLz LAST-MODIFIEDr )Ú
|
splitlinesrÌ rñ ÚrstripÚsplitÚupperrU rv rS Úrrulestrr rN r r )r r? ÚlinesrÞ Úliner] r^ ÚinvtzÚcomptyperO r ÚparmsÚ founddtstartrP rQ Ú
|
rrulelinesr$ Úrrrh ÚparmÚmsgs r rw ztzical._parse_rfc2 sç Ø ÙÜ ^Ó,Ð ,ð Ø#e*nØ8??Ó$DÙØ!HØQ4 7 c>Øac
|
d 1 2hÑ&
|
Ø!HàQð #e*nð ØØØØó f DÙØØ ** S¨!Ó,KD%ØJJsOEÙÜ Ð!6Ó7Ð7Ø8>>Ó#DØ!"IEÚØ7?Ø Ð 8Ñ8à ä (Ð)>¸uÑ)DÓ EÐEØ $HØ#(LØ#'LØ!%JØ!#JØ !FØU]Ø Ò+Ù#Ü",Ð-EÀhÑ-NÓ"OÐ OÙ #Ü",Ð-GÓ"HÐ HÙ $Ü",Ø Bó#Dð Dô +5°T¸5Ó*A $Ø %Ø (Ò*Ù +Ü",Ð-JÓ"KÐ KØ'Ð/Ü",Ø Bó#Dð Dà%Ð-Ü",Ø Bó#Dð Dð "Ù%Ü!&§ ¡ °· ± ¸*Ó0EØ;?Ø9=Ø6:ð "0ó "<Bô .¨l¸JØ/7¸:Ñ/EØ.4°bó :ð TÔ*Ø#'ä (Ð)BÀ5Ñ)HÓ IÐIÙ ØyÒ(ð %*ò 6DØ #Ð'8Ó 8ð(5Ø7;ñ(< ä&0°£oÐ 5ð 6ð
|
#×)Ñ)¨$Ô/Ø'+ Ø Ð!GÑGØ"×)Ñ)¨$Ö/Ø Ò/Ù Ý",Ú>BÀEÈ!ÃHÐ Mó#Oð Oà'+×'9Ñ'9¸%Ó'@ Ø Ò-Ù Ü",Ø ?ÀÀaÁÑ Hó#Jð Jà%)×%7Ñ%7¸Ó%>
|
Ø Ò)Ù Ü",Ø ;¸EÀ!¹HÑ Dó#Fð Fà!&Ø Ò*Ù ä (Ð)AÀ$Ñ)FÓ GÐGàv~Ù Ü",Ø 9¸%À¹(Ñ Bó#Dð Dà $Ø Ð!FÑFÙ ä (Ð)AÀ$Ñ)FÓ GÐGØ U¨kÔ%9ØØØ ñMf r c ó` | j j dt | j « dS r
|
rK r: s r r; ztzical.__repr__¯ rL r r )
|
r9 r= r> r? rQ rz r® r rw r; r# r r rs rs å s( ñ ò)ò"&ó #ò65ò { ózCr rs Úwin32z/etc/localtimerx )z/usr/share/zoneinfoz/usr/lib/zoneinfoz/usr/share/lib/zoneinfoz /etc/zoneinfoc ób t ft
|
t fz G fddt « } | « S )Nc óB e Zd ZdZd Zd fd Zd Zd Zedd« Z y) ú __get_gettz.<locals>.GettzFunca
|
Retrieve a time zone object from a string representation
|
|
This function is intended to retrieve the :py:class:`tzinfo` subclass
|
that best represents the time zone that would be used if a POSIX
|
`TZ variable`_ were set to the same value.
|
|
If no argument or an empty string is passed to ``gettz``, local time
|
is returned:
|
|
.. code-block:: python3
|
|
>>> gettz()
|
tzfile('/etc/localtime')
|
|
This function is also the preferred way to map IANA tz database keys
|
to :class:`tzfile` objects:
|
|
.. code-block:: python3
|
|
>>> gettz('Pacific/Kiritimati')
|
tzfile('/usr/share/zoneinfo/Pacific/Kiritimati')
|
|
On Windows, the standard is extended to include the Windows-specific
|
zone names provided by the operating system:
|
|
.. code-block:: python3
|
|
>>> gettz('Egypt Standard Time')
|
tzwin('Egypt Standard Time')
|
|
Passing a GNU ``TZ`` style string time zone specification returns a
|
:class:`tzstr` object:
|
|
.. code-block:: python3
|
|
>>> gettz('AEST-10AEDT-11,M10.1.0/2,M4.1.0/3')
|
tzstr('AEST-10AEDT-11,M10.1.0/2,M4.1.0/3')
|
|
:param name:
|
A time zone name (IANA, or, on Windows, Windows keys), location of
|
a ``tzfile(5)`` zoneinfo file or ``TZ`` variable style time zone
|
specifier. An empty string, no argument or ``None`` is interpreted
|
as local time.
|
|
:return:
|
Returns an instance of one of ``dateutil``'s :py:class:`tzinfo`
|
subclasses.
|
|
.. versionchanged:: 2.7.0
|
|
After version 2.7.0, any two calls to ``gettz`` using the same
|
input strings will return the same object:
|
|
.. code-block:: python3
|
|
>>> tz.gettz('America/Chicago') is tz.gettz('America/Chicago')
|
True
|
|
In addition to improving performance, this ensures that
|
`"same zone" semantics`_ are used for datetimes in the same zone.
|
|
|
.. _`TZ variable`:
|
https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html
|
|
.. _`"same zone" semantics`:
|
https://blog.ganssle.io/articles/2018/02/aware-datetime-arithmetic.html
|
c ó t j « | _ d| _ t « | _ t j « | _ y )NrÇ ) ÚweakrefÚWeakValueDictionaryÚ_GettzFunc__instancesÚ _GettzFunc__strong_cache_sizer Ú_GettzFunc__strong_cacher r[ r\ r: s r rQ z'__get_gettz.<locals>.GettzFunc.__init__ s6 ä &× :Ñ :Ó <DÔ Ø'(DÔ $Ü"-£-DÔ Ü &× 4Ñ 4Ó 6DÕ r Nc óÐ | j 5 | j j |d « }|=| j |¬« }| t |« s||| j |< n |cd d d « S | j
|
j ||« | j
|
|< t | j
|
« | j kD r | j
|
j d¬« d d d « |S # 1 sw Y S xY w)N)rO F©Úlast)
|
r\ r´ r® Únocacher+ r¶ re rñ rµ Úpopitem)r rO ÚrvÚtzlocal_classess r Ú__call__z'__get_gettz.<locals>.GettzFunc.__call__ sá ø Ø×!Ñ!ñ <Ø×%Ñ%×)Ñ)¨$°Ó5à:Ø ¨4 Ó0BØ LÜ )¨"¨oÔ >Ø !zð 24×(Ñ(¨Ò.ð "÷# <ñ <ð& -1×,?Ñ,?×,CÑ,CÀDÈ"Ó,M×#Ñ# DÑ)ät×*Ñ*Ó+¨d×.FÑ.FÒFØ×'Ñ'×/Ñ/°UÐ/Ô;÷- <ð0 I÷1 <ð0 Iús ACÁ*A'CÃC%c óî | j 5 || _ t | j « |kD r5| j j d¬« t | j « |kD r5d d d « y # 1 sw Y y xY w)NFr¸ )r\ rµ rñ r¶ r» )r Úsizes r Úset_cache_sizez-__get_gettz.<locals>.GettzFunc.set_cache_size+ sg Ø×!Ñ!ñ <Ø+/Ô(Ü$×-Ñ-Ó.°Ò5Ø×'Ñ'×/Ñ/°UÐ/Ô;ô $×-Ñ-Ó.°Ó5÷ <÷ <ñ <ús AA+Á+A4c ó¬ | j 5 t j « | _ | j j « d d d « y # 1 sw Y y xY wr )r\ r² r³ r´ r¶ Úclearr: s r Ú cache_clearz*__get_gettz.<locals>.GettzFunc.cache_clear1 sC Ø×!Ñ!ñ ,Ü#*×#>Ñ#>Ó#@Ô Ø×#Ñ#×)Ñ)Ô+÷ ,÷ ,ñ ,ús 4A
|
Á
|
Ac óæ d}| s t j d } | | dv r³t D ] }t j j |« sO|}t D ]C }t j j ||« }t j j |« sC n qt j j |« s t |« } |S t « }|S | j d« r| dd } t j j | « r0t j j | « r t | « }|S d}|S t D ] }t j j || « }t j j |« s2|j) dd« }t j j |« st t |« } |S d}t* t+ | « }|s d d
|
lm} |« j5 | « }|sB| D ] }|d v s t7 | « } |S | d v rt8 }|S | t: j< v r
|
t « }|S # t $ r Y -w xY w# t t t f$ r Y <w xY w# t $ r>}t! | t" « r"d}t% j& t |« |« n Y d}~¾d}~ww xY w# t t t f$ r Y w xY w# t, t. f$ r d}Y w xY w# t $ r Y |S w xY w) z A non-cached version of gettzNÚTZ)Ú r r r z'gettz argument should be str, not bytesr rÀ r )Úget_zonefile_instanceÚ
|
0123456789r7 ) rÒ ÚenvironÚKeyErrorÚTZFILESÚpathÚisabsÚTZPATHSr Úisfiler± ÚIOErrorÚOSErrorrÌ ra Ú
|
startswithrJ r+ ÚbytesÚsixÚ
|
raise_fromra r Ú WindowsErrorÚUnicodeEncodeErrorÚdateutil.zoneinforÈ r® r4 r" rd r$ ) rO ÚtzÚfilepathr» rÍ ÚeÚnew_msgrÈ Úcs r rº z&__get_gettz.<locals>.GettzFunc.nocache6 sö ð BÙðÜ :: dÑ+Dð |t yÑ 0Ü 'ò #HÜ 77==¨Ô2Ø#+Ü$+ò %DÜ')§w¡w§|¡|°D¸(Ó'CHÜ !ww~~¨hÕ 7Ù %ð%ð
|
%Üww~~ hÕ/ð!Ü!'¨Ó!1BØ !ð| IðU#ô !Bðt Iðq Ø sÔ+Ø # A Bxô 77== Ô&Üww~~ dÔ+Ü # D\ðZ IðW "ðV IôS !(ò (3Ü#%§7¡7§<¡<°°dÓ#;Ü !ww~~¨hÔ 7Ø'/×'7Ñ'7¸¸SÓ'AHÜ#%§7¡7§>¡>°(Ô#;Ø (ð!Ü!'¨Ó!1BØ !ðB IðS(3ð "Ü Ð,ð *Ü%*¨4£[ ñ
|
"Ý OÙ!6Ó!8×!<Ñ!<¸TÓ!BBá !Ø%)ò 3 ð
|
$%¨ Ò#4ð%-Ü-2°4«[¨ð %*ð Ið! 3ð $(¨>Ñ#9Ü), Bð Ið &*¬T¯[©[Ñ%8Ü)0« BØIøô[ ò Úðûô !(¬´*Ð =ò !Ú ð!ûô !ò Ü! $¬Ô.Ø"Kܤy°Ó'9¸1Õ=à õ >ûð ûô* !(¬´*Ð =ò !Ú ð!ûô %1Ô2DÐ#Eò *à%)£ð *ûô" ,6ò %-Ø(,Ø$)ð Ið%-úsq H: Â7 I
|
ÃI% Æ3 J/Ç K
|
È K"È: IÉIÉ
|
I"É!I"É% J,É.3J'Ê'J,Ê/KËKË
|
K Ë K Ë" K0Ë/K0r )
|
r9 r= r> r? rQ r¾ rÁ rÄ Ú staticmethodrº )r½ s r Ú GettzFuncr° Ã s4 ø ñD òJ 7õ ò6 <ò ,ð
|
|
òS ó
|
ñS r rà )ra r rA )rà r½ s @r Ú __get_gettzrá ¾ s5 ø Ü jOÜÐ ØJ=Ñ(öGFô GñR ;Ðr c ó |#| j t d« | j }| j d¬« } | j |¬« j t « j |« }|j d¬« }| |k( S )a
|
Given a datetime and a time zone, determine whether or not a given datetime
|
would fall in a gap.
|
|
:param dt:
|
A :class:`datetime.datetime` (whose time zone will be ignored if ``tz``
|
is provided.)
|
|
:param tz:
|
A :class:`datetime.tzinfo` with support for the ``fold`` attribute. If
|
``None`` or not provided, the datetime's own time zone will be used.
|
|
:return:
|
Returns a boolean value whether or not the "wall time" exists in
|
``tz``.
|
|
.. versionadded:: 2.7.0
|
Nú,Datetime is naive and no time zone provided.r` )rû rÌ ra Ú
|
astimezoner" )r rÚ Údt_rts r Údatetime_existsræ sz ð&
|
zØ 99Ð Ü Ð KÓLÐ LØ YYà 4Ó Bð JJbJÓ !× ,Ñ ,¬SÓ 1× <Ñ <¸RÓ @EØ MM MÓ &Eà ;Ðr c ó |#| j t d« | j }t |dd« }| |j | « S | j |¬« } t | d¬« }t | d¬« }|j « |j « k( }|j « |j « k( }|xr | S # t $ r Y w xY w)a\
|
Given a datetime and a time zone, determine whether or not a given datetime
|
is ambiguous (i.e if there are two times differentiated only by their DST
|
status).
|
|
:param dt:
|
A :class:`datetime.datetime` (whose time zone will be ignored if ``tz``
|
is provided.)
|
|
:param tz:
|
A :class:`datetime.tzinfo` with support for the ``fold`` attribute. If
|
``None`` or not provided, the datetime's own time zone will be used.
|
|
:return:
|
Returns a boolean value whether or not the "wall time" is ambiguous in
|
``tz``.
|
|
.. versionadded:: 2.6.0
|
Nrã r' r` r rú r ) rû rÌ r} r' Ú Exceptionra r
|
r r )r rÚ Úis_ambiguous_fnÚwall_0Úwall_1Ú same_offsetÚsame_dsts r Údatetime_ambiguousrî µ sÐ ð(
|
zØ 99Ð Ü Ð KÓLÐ Là YYô b .°$Ó7OØÐ"ð Ø?? 2Ó&Ð &ð
|
2Ó BÜ BQÔ FÜ BQÔ Fà×"Ñ"Ó$¨×(8Ñ(8Ó(:Ñ:KØzz|vzz|Ñ+HàÒ( Ð )Ð)øô ò Ù ð ús ¶B< Â< CÃCc óà | j at | « sV| t j d¬« z j « }| t j d¬« z
|
j « }| ||z
|
z } | S )aZ
|
Given a datetime that may be imaginary, return an existing datetime.
|
|
This function assumes that an imaginary datetime represents what the
|
wall time would be in a zone had the offset transition not occurred, so
|
it will always fall forward by the transition's change in offset.
|
|
.. doctest::
|
|
>>> from dateutil import tz
|
>>> from datetime import datetime
|
>>> NYC = tz.gettz('America/New_York')
|
>>> print(tz.resolve_imaginary(datetime(2017, 3, 12, 2, 30, tzinfo=NYC)))
|
2017-03-12 03:30:00-04:00
|
|
>>> KIR = tz.gettz('Pacific/Kiritimati')
|
>>> print(tz.resolve_imaginary(datetime(1995, 1, 1, 12, 30, tzinfo=KIR)))
|
1995-01-02 12:30:00+14:00
|
|
As a note, :func:`datetime.astimezone` is guaranteed to produce a valid,
|
existing datetime, so a round-trip to and from UTC is sufficient to get
|
an extant datetime, however, this generally "falls back" to an earlier time
|
rather than falling forward to the STD side (though no guarantees are made
|
about this behavior).
|
|
:param dt:
|
A :class:`datetime.datetime` which may or may not exist.
|
|
:return:
|
Returns an existing :class:`datetime.datetime`. If ``dt`` was not
|
imaginary, the datetime returned is guaranteed to be the same object
|
passed to the function.
|
|
.. versionadded:: 2.7.0
|
rÅ r )rû ræ rL rM r )r Ú curr_offsetÚ
|
old_offsets r Úresolve_imaginaryrò ã sf ðH
|
yyÐ ¤_°RÔ%8àH× .Ñ .°RÔ 8Ñ8×CÑCÓE Ø8×-Ñ-°BÔ7Ñ7×BÑBÓD
|
à
|
kJÑ&Ñ&à Ir c óP | j d¬« t z
|
j « S )z
|
Convert a :class:`datetime.datetime` object to an epoch timestamp in
|
seconds since January 1, 1970, ignoring the time zone.
|
Nr` )ra ÚEPOCHrI )r s r rw rw s# ð
|
JJdJÓ #¤eÑ +× :Ñ :Ó <Ð<r )é rÆ c ó | S r r# )Ú second_offsets r rN rN s Ø Ð r c ó | }d| dz dz z }|S )Nr é r# )r÷ rñ Úcalculated_offsets r rN rN s$ ð
|
#
|
Ø =°2Ñ#5¸"Ñ"<Ñ =ÐØ Ð r )Ú nullcontextc ó" e Zd ZdZd Zd Zd Zy)r· zj
|
Class for wrapping contexts so that they are passed through in a
|
with statement.
|
c ó || _ y r ©Úcontext)r rÿ s r rQ z_nullcontext.__init__0 s Ø"DLr c ó | j S r rþ r: s r Ú __enter__z_nullcontext.__enter__3 s Ø<<Ð r c ó y r r# )Úargsr¯ s r Ú__exit__z_nullcontext.__exit__6 s Ø r N)r9 r= r> r? rQ r r r# r r r· r· + s ñ ò #ò ó r r· r )@r? rL rÍ rd ÚsysrÒ rì r² Ú collectionsr rÕ r Ú six.movesr Ú_commonr r r r
|
r Ú
|
_factoriesr r r Úwinr r Ú ImportErrorÚwarningsr rM r rô Ú toordinalÚ EPOCHORDINALÚ add_metaclassrû r r" r, ra rA r r£ r± r r4 rN rU rs ÚplatformrÌ rÏ rá Úgettzræ rî rò rw Ú version_inforN Ú
|
contextlibrû r· r# r r ú<module>r s> ðñó Û Û Û
|
Û Û Û Ý #ã
|
Ý Ý ß /ß (Ý -ç 6Ý %ð ß&õ
|
àx×Ñ!Ó Ø×Ñ$ 1 a¨Ó+ØÓ ð ×Ñ<Ó ôQ#HOOó Q#ó !ðQ#ñn gð ×ÑÐ#Ó$ôA#xó A#ó %ðA#ôH|#gô |#ô~*1fô *1ôZ
|
8fô
|
8ôeGWô eGôP_&kô _&ðD ×Ñ=Ó!ôtCGó tCó "ðtCônVô ôS#ô S#ôlKCVô KCð\ <<7ÒØ Ð-Gò Gð
|
GØGòNñb Øó óD+*ò\+ò\=ð ×ÑvÒ ó ò!ðæ6øðW8 ò Ø Ð EJð ûðX8 ò ô vö ð ús$ ÁG Æ?G Ç GÇGÇG)Ç(G)
|
