3
+e58 @ s d Z dZdZeZeZddddddd d
d d d
dg ZddlZddlZddlZ ddl
Z
ddl m Z ddl m
Z
ddl mZ ddl mZ ddlmZmZmZ ddlmZ ddlmZmZ ye W n ek
r eZdd Z Y n
X dd Z e j dpd Z e j e j r
e ddI Z d d Z!d d! Z"i Z#d"d Z$d#d$ Z%ej&dZ'ej&d d%Z(G d&d' d'ej)Z*e* Z*Z+d(d) Z,d*e,_-d+d, Z.d*e._-G d-d. d.eZ/e/ Z0G d/d0 d0eZ1e1 Z2G d1d2 d2ej)Z3i fd3d4Z4d*e4_-d5d6 Z5e6d7kre5 g Z7xTe j8e D ]F\Z9Z:Z;x$dJD ] Zd:d; e;D qW ed e@e jAjBe d?D ZCeCj>d@dAdBdCdDdEdFdGd'g edHd; eCD ZCeeCZDdS )Kz
datetime.tzinfo timezone definitions generated from the
Olson timezone database:
ftp://elsie.nci.nih.gov/pub/tz*.tar.gz
See the datetime section of the Python Library Reference for information
on how to use these modules.
Z2017bz2017.2timezoneutccountry_timezones
country_namesAmbiguousTimeErrorInvalidTimeErrorNonExistentTimeErrorUnknownTimeZoneError
all_timezonesall_timezones_setcommon_timezonescommon_timezones_set N)r )r )r )r )LazyDictLazyListLazySet) unpickler) build_tzinfo _byte_stringc C s | j d | S )z
>>> ascii('Hello')
'Hello'
>>> ascii('\N{TRADE MARK SIGN}') #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
UnicodeEncodeError: ...
ASCII)encode)s r /usr/lib/python3.6/__init__.pyascii. s
r c C s
| j dS )a
>>> ascii('Hello')
'Hello'
>>> ascii(u'Hello')
'Hello'
>>> ascii(u'\N{TRADE MARK SIGN}') #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
UnicodeEncodeError: ...
r )r )r r r r r < s ZTZDIRz/usr/share/zoneinfo c C s^ | j djd}x0|D ](}|tjjks2tjj|krtd| qW tjjtf| }t |dS )zOpen a resource from the zoneinfo subdir for reading.
Uses the pkg_resources module if available and no standard file
found at the calculated location.
/zBad path segment: %rrb)
lstripsplitospathpardirsep
ValueErrorjoin _tzinfo_diropen)nameZ
name_partspartfilenamer r r
open_resourceM s
r* c C s* yt | j dS tk
r$ dS X dS )z(Return true if the given resource existsTFN)r* closeIOError)r' r r r resource_exists[ s
r- c C s | j dkrtS y t| } W n tk
r8 t| Y nX t| } | tkr| tkrzt| }zt | |t| < W d|j
X nt| t| S )ao Return a datetime.tzinfo implementation for the given timezone
>>> from datetime import datetime, timedelta
>>> utc = timezone('UTC')
>>> eastern = timezone('US/Eastern')
>>> eastern.zone
'US/Eastern'
>>> timezone(unicode('US/Eastern')) is eastern
True
>>> utc_dt = datetime(2002, 10, 27, 6, 0, 0, tzinfo=utc)
>>> loc_dt = utc_dt.astimezone(eastern)
>>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
>>> loc_dt.strftime(fmt)
'2002-10-27 01:00:00 EST (-0500)'
>>> (loc_dt - timedelta(minutes=10)).strftime(fmt)
'2002-10-27 00:50:00 EST (-0500)'
>>> eastern.normalize(loc_dt - timedelta(minutes=10)).strftime(fmt)
'2002-10-27 01:50:00 EDT (-0400)'
>>> (loc_dt + timedelta(minutes=10)).strftime(fmt)
'2002-10-27 01:10:00 EST (-0500)'
Raises UnknownTimeZoneError if passed an unknown zone.
>>> try:
... timezone('Asia/Shangri-La')
... except UnknownTimeZoneError:
... print('Unknown')
Unknown
>>> try:
... timezone(unicode('\N{TRADE MARK SIGN}'))
... except UnknownTimeZoneError:
... print('Unknown')
Unknown
UTCN) upperr r UnicodeEncodeErrorr
_unmunge_zone
_tzinfo_cacher
r* r r+ )zonefpr r r r u s % c C s | j ddj ddS )z?Undo the time zone name munging done by older versions of pytz.Z_plus_+Z_minus_-)replace)r3 r r r r1 s r1 )Zhoursc st e Zd ZdZd ZeZeZeZ fddZ dd Z
dd Z dd Z d
d Z
dd
dZdddZdd Zdd Z ZS )r. zUTC
Optimized UTC implementation. It unpickles using the single module global
instance defined beneath this class declaration.
c s& |j d kr| j|S ttj| j|S )N)tzinfolocalizesuperr __class__fromutc)selfdt)r; r r r< s
z UTC.fromutcc C s t S )N)ZERO)r= r> r r r utcoffset s z
UTC.utcoffsetc C s dS )Nr. r )r= r> r r r tzname s z
UTC.tznamec C s t S )N)r? )r= r> r r r dst s zUTC.dstc C s t f fS )N)_UTC)r= r r r
__reduce__ s zUTC.__reduce__Fc C s |j dk rtd|j| dS )z Convert naive time to local timeNz*Not naive datetime (tzinfo is already set))r8 )r8 r# r7 )r= r> is_dstr r r r9 s
z UTC.localizec C s* |j | kr|S |j dkr td|j| S )z6Correct the timezone information on the given datetimeNzNaive time - no tzinfo set)r8 r#
astimezone)r= r> rE r r r normalize s
z
UTC.normalizec C s dS )Nzr )r= r r r __repr__ s z UTC.__repr__c C s dS )Nr. r )r= r r r __str__ s z UTC.__str__)F)F)__name__
__module__ __qualname____doc__r3 r? Z
_utcoffsetZ_dstZ_tznamer< r@ rA rB rD r9 rG rH rI
__classcell__r r )r; r r. s
r. c C s t S )a* Factory function for utc unpickling.
Makes sure that unpickling a utc instance always returns the same
module global.
These examples belong in the UTC class above, but it is obscured; or in
the README.txt, but we are not depending on Python 2.4 so integrating
the README.txt examples with the unit tests is not trivial.
>>> import datetime, pickle
>>> dt = datetime.datetime(2005, 3, 1, 14, 13, 21, tzinfo=utc)
>>> naive = dt.replace(tzinfo=None)
>>> p = pickle.dumps(dt, 1)
>>> naive_p = pickle.dumps(naive, 1)
>>> len(p) - len(naive_p)
17
>>> new = pickle.loads(p)
>>> new == dt
True
>>> new is dt
False
>>> new.tzinfo is dt.tzinfo
True
>>> utc is UTC is timezone('UTC')
True
>>> utc is timezone('GMT')
False
)r r r r r rC s rC Tc G s t | S )zFactory function for unpickling pytz tzinfo instances.
Just a wrapper around tzinfo.unpickler to save a few bytes in each pickle
by shortening the path.
)r )argsr r r _p s rP c @ s e Zd ZdZdd Zdd ZdS )_CountryTimezoneDicta Map ISO 3166 country code to a list of timezone names commonly used
in that country.
iso3166_code is the two letter code used to identify the country.
>>> def print_list(list_of_strings):
... 'We use a helper so doctests work under Python 2.3 -> 3.x'
... for s in list_of_strings:
... print(s)
>>> print_list(country_timezones['nz'])
Pacific/Auckland
Pacific/Chatham
>>> print_list(country_timezones['ch'])
Europe/Zurich
>>> print_list(country_timezones['CH'])
Europe/Zurich
>>> print_list(country_timezones[unicode('ch')])
Europe/Zurich
>>> print_list(country_timezones['XXX'])
Traceback (most recent call last):
...
KeyError: 'XXX'
Previously, this information was exposed as a function rather than a
dictionary. This is still supported::
>>> print_list(country_timezones('nz'))
Pacific/Auckland
Pacific/Chatham
c C s | | S )zBackwards compatibility.r )r= Z iso3166_coder r r __call__; s z _CountryTimezoneDict.__call__c C s i }t d}zxx|D ]p}|jd}|jdr.q|jd dd d \}}}|tkrRqy|| j| W q tk
r |g||< Y qX qW || _W d |j X d S )Nzzone.tabzUTF-8# ) r* decode
startswithr r
appendKeyErrordatar+ )r= rZ zone_tablinecodeZ coordinatesr3 r r r _fill? s
z_CountryTimezoneDict._fillN)rJ rK rL rM rR r^ r r r r rQ s rQ c @ s e Zd ZdZdd ZdS )_CountryNameDictzgDictionary proving ISO3166 code -> English name.
>>> print(country_names['au'])
Australia
c
C sj i }t d}zNxB|j D ]6}|jd}|jdr2q|jd d\}}|j ||< qW || _W d |j X d S )Nz iso3166.tabzUTF-8rS r )r* readlinesrV rW r striprZ r+ )r= rZ r[ r\ r] r' r r r r^ [ s
z_CountryNameDict._fillN)rJ rK rL rM r^ r r r r r_ U s r_ c @ sT e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dddZ
dddZ dS ) _FixedOffsetNc C s. t |dkrtd||| _tj|d| _d S )Ni z absolute offset is too large)minutes)absr# _minutesdatetime timedelta_offset)r= rc r r r __init__r s
z_FixedOffset.__init__c C s | j S )N)rh )r= r> r r r r@ x s z_FixedOffset.utcoffsetc C s t | jffS )N) FixedOffsetre )r= r r r rD { s z_FixedOffset.__reduce__c C s t S )N)r? )r= r> r r r rB ~ s z_FixedOffset.dstc C s d S )Nr )r= r> r r r rA s z_FixedOffset.tznamec C s
d| j S )Nzpytz.FixedOffset(%d))re )r= r r r rH s z_FixedOffset.__repr__Fc C s |j dk rtd|j| dS )z Convert naive time to local timeNz*Not naive datetime (tzinfo is already set))r8 )r8 r# r7 )r= r> rE r r r r9 s
z_FixedOffset.localizec C s* |j | kr|S |j dkr td|j| S )z6Correct the timezone information on the given datetimeNzNaive time - no tzinfo set)r8 r# rF )r= r> rE r r r rG s
z_FixedOffset.normalize)F)F) rJ rK rL r3 ri r@ rD rB rA rH r9 rG r r r r rb n s
rb c C s2 | dkr t S |j| }|dkr.|j| t| }|S )a return a fixed-offset timezone based off a number of minutes.
>>> one = FixedOffset(-330)
>>> one
pytz.FixedOffset(-330)
>>> one.utcoffset(datetime.datetime.now())
datetime.timedelta(-1, 66600)
>>> one.dst(datetime.datetime.now())
datetime.timedelta(0)
>>> two = FixedOffset(1380)
>>> two
pytz.FixedOffset(1380)
>>> two.utcoffset(datetime.datetime.now())
datetime.timedelta(0, 82800)
>>> two.dst(datetime.datetime.now())
datetime.timedelta(0)
The datetime.timedelta must be between the range of -1 and 1 day,
non-inclusive.
>>> FixedOffset(1440)
Traceback (most recent call last):
...
ValueError: ('absolute offset is too large', 1440)
>>> FixedOffset(-1440)
Traceback (most recent call last):
...
ValueError: ('absolute offset is too large', -1440)
An offset of 0 is special-cased to return UTC.
>>> FixedOffset(0) is UTC
True
There should always be only one instance of a FixedOffset per timedelta.
This should be true for multiple creation calls.
>>> FixedOffset(-330) is one
True
>>> FixedOffset(1380) is two
True
It should also be true for pickling.
>>> import pickle
>>> pickle.loads(pickle.dumps(one)) is one
True
>>> pickle.loads(pickle.dumps(two)) is two
True
r
N)r. get
setdefaultrb )offsetZ_tzinfosinfor r r rj s 5
rj c C s: dd l } dd l}dd l}|jjd|j dd l}| j|S )Nr
)doctestr sysr insertr! pytzZtestmod)ro r rp rr r r r _test s rs __main__posixrightc c sD | ]<}|d kr|dkrd|krt jjt|ttd d V qdS )ZREADMEZTheory.r N)r r r$ rootlenr% ).0Ztz_filer r r s r{ c c s | ]}t |r|V qd S )N)r- )rz tzr r r r{ s c C s, g | ]$}|d kr|d dkr|j d qS ) r
rS )r )rz lr r r
s r zzone.tabZGMTz US/Alaskaz
US/Arizonaz
US/Centralz
US/Easternz US/Hawaiiz US/Mountainz
US/Pacificc c s | ]}|t kr|V qd S )N)r )rz r| r r r r{ s )ru rv )ErM Z
OLSON_VERSIONVERSION __version__Z
OLSEN_VERSION__all__rp rf Zos.pathr gettextZpytz.exceptionsr r r r Z pytz.lazyr r r Z pytz.tzinfor Z pytz.tzfiler r Zunicode NameErrorstrr getenvr% endswithr" r* r- r2 r r1 rg r? ZHOURr8 r. r rC Z__safe_for_unpickling__rP rQ r r_ r rb rj rs rJ r walkrx dirsfilesexcludeindexextendr
r& r r$ r r r r r r s
<
2
7( B