a
e: @ s d Z ddlZddlZddlZddlmZ ddlmZ ddlmZ ddlm Z ddl
m Z m Z m
Z
ddlmZmZ dd lmZ d
Zd ZeZeZg d Zejd d
kreZdd Zndd Ze dpdZ e ej re dd Z dd Z dd Z!i Z"dd Z#dd Z$da%d d Z&e'dZ(ej'd d Z)G d d! d!eZ*e* Z*Z+d"d# Z,d$e,_-d%d& Z.d$e._-G d'd( d(e Z/e/ Z0G d)d* d*e Z1e1 Z2G d+d, d,ej3Z4i fd-d.Z5d$e5_-d/d0 Z6e7d1kre6 g Z8e9e D ]B\Z:Z;Ze== qe8?d3d4 e>> ascii('Hello')
'Hello'
>>> ascii('\N{TRADE MARK SIGN}') #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
UnicodeEncodeError: ...
ASCII)typebytesdecodeencodes r 1/usr/lib/python3.9/site-packages/pytz/__init__.pyascii/ s
r c C s
| 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 PYTZ_TZDATADIRz/usr/share/zoneinfoc C sj | dd}|D ](}|tjjks0tjj|v rtd| qtjdt }tjj
|g|R }t |dS )a! Open a resource from the zoneinfo subdir for reading.
Uses the pkg_resources module if available and no standard file
found at the calculated location.
It is possible to specify different location for zoneinfo
subdir by using the PYTZ_TZDATADIR environment variable.
/zBad path segment: %rr rb) lstripsplitospathpardirsep
ValueErrorenvironget _tzinfo_dirjoinopen)nameZ
name_partspartZ zoneinfo_dirfilenamer r r
open_resourceQ s r3 c C s@ z&t jddrW dS t| W dS ty: Y dS 0 dS )z(Return true if the given resource existsZPYTZ_SKIPEXISTSCHECK TFN)r& r+ r, r3 closeIOError)r0 r r r resource_existsc s r7 c C s | du rt d| dkr tS z t| } W n tyF t | Y n0 tt| } | tvr| tv rt | }zt
| |t| < W | q| 0 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
NUTC) r upperr
r UnicodeEncodeError _case_insensitive_zone_lookup
_unmunge_zone
_tzinfo_cacher r3 r r5 )zonefpr r r r v s" % r c C s | dd ddS )z?Undo the time zone name munging done by older versions of pytz.Z_plus_+Z_minus_-)replacer> r r r r< s r< c C s, t du rtdd tD a t | p*| S )z@case-insensitively matching timezone, else return zone unchangedNc s s | ]}| |fV qd S N)lower.0Ztzr r r z0_case_insensitive_zone_lookup..) _all_timezones_lower_to_standarddictr r, rE rC r r r r; s r; )Zhoursc st e Zd ZdZd ZeZeZeZ fddZ dd Z
dd Z dd Z d
d Z
dd
dZdddZdd Zdd Z ZS )r8 zUTC
Optimized UTC implementation. It unpickles using the single module global
instance defined beneath this class declaration.
c s& |j d u r| |S ttj| |S rD )tzinfolocalizesuperr
__class__fromutcselfdtrP r r rQ s
z UTC.fromutcc C s t S rD ZEROrR r r r utcoffset s z
UTC.utcoffsetc C s dS Nr8 r rR r r r tzname s z
UTC.tznamec C s t S rD rV rR r r r dst s zUTC.dstc C s t dfS )Nr )_UTCrS r r r
__reduce__ s zUTC.__reduce__Fc C s |j durtd|j| dS z Convert naive time to local timeNz*Not naive datetime (tzinfo is already set))rM rM r* rB rS rT Zis_dstr r r rN s
z UTC.localizec C s* |j | u r|S |j du r td|| S z6Correct the timezone information on the given datetimeNzNaive time - no tzinfo setrM r* Z
astimezonera 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 rY r r] r r r __str__ s z UTC.__str__)F)F)__name__
__module__ __qualname____doc__r> rW Z
_utcoffsetZ_dstZ_tznamerQ rX rZ r[ r^ rN rd re rf
__classcell__r r rU r r8 s
r8 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.rst, but we are not depending on Python 2.4 so integrating
the README.rst 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 r\ s r\ 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 rm 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 )rS Z iso3166_coder r r __call__M s z _CountryTimezoneDict.__call__c C s i }t d}z|D ]n}|d}|dr,q|d dd d \}}}|tvrPqz|| | W q ty~ |g||< Y q0 q|| _W | n
| 0 d S )Nzone.tabUTF-8# ) r3 r
startswithr% r appendKeyErrordatar5 )rS rx zone_tablinecodeZ coordinatesr> r r r _fillQ s
z_CountryTimezoneDict._fillN)rg rh ri rj ro r| r r r r rn - s rn c @ s e Zd ZdZdd ZdS )_CountryNameDictzgDictionary proving ISO3166 code -> English name.
>>> print(country_names['au'])
Australia
c C sn i }t d}zR| D ]6}|d}|dr0q|d d\}}| ||< q|| _W | n
| 0 d S )Nz iso3166.tabrq rr rL )r3 readlinesr ru r% striprx r5 )rS rx ry rz r{ r0 r r r r| n s
z_CountryNameDict._fillN)rg rh ri rj r| r r r r r} h 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)rS r r r r __init__ s
z_FixedOffset.__init__c C s | j S rD )r rR r r r rX s z_FixedOffset.utcoffsetc C s t | jffS rD )r r r] r r r r^ s z_FixedOffset.__reduce__c C s t S rD rV rR r r r r[ s z_FixedOffset.dstc C s d S rD r rR r r r rZ s z_FixedOffset.tznamec C s
d| j S )Nzpytz.FixedOffset(%d))r r] r r r re s z_FixedOffset.__repr__Fc C s |j durtd|j| dS r_ r` ra r r r rN s
z_FixedOffset.localizec C s* |j | u r|S |j du r td|| S rb rc ra r r r rd s
z_FixedOffset.normalize)F)F) rg rh ri r> r rX r^ r[ rZ re rN rd r r r r r s
r c C s2 | dkr t S || }|du r.|| t| }|S )a return a fixed-offset timezone based off a number of minutes.
>>> one = FixedOffset(-330)
>>> one
pytz.FixedOffset(-330)
>>> str(one.utcoffset(datetime.datetime.now()))
'-1 day, 18:30:00'
>>> str(one.dst(datetime.datetime.now()))
'0:00:00'
>>> two = FixedOffset(1380)
>>> two
pytz.FixedOffset(1380)
>>> str(two.utcoffset(datetime.datetime.now()))
'23:00:00'
>>> str(two.dst(datetime.datetime.now()))
'0:00:00'
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)r8 r,
setdefaultr )offsetZ_tzinfosinfor r r r s 5
r c C s* dd l } tjdtj dd l}| |S )Nr )doctestsysr' insertr& r( pytzZtestmod)r r r r r _test s r __main__)posixrightc c s< | ]4}|d vrd|vrt jt|ttd d V qdS ))Z leapsecondsZREADMEZTheory.rL N)r& r' r. rootlenr- )rG Ztz_filer r r rH s rH c c s | ]}t |r|V qd S rD )r7 rF r r r rH s rp c C s, g | ]$}|d kr|d dkr| d qS )r4 r rr r )r% )rG lr r r
s r ) ZGMTz US/Alaskaz
US/Arizonaz
US/Centralz
US/Easternz US/Hawaiiz US/Mountainz
US/Pacificr8 c c s | ]}|t v r|V qd S rD )r rF r r r rH s )Grj r r Zos.pathr& Zpytz.exceptionsr r r r Z pytz.lazyr r r Z pytz.tzinfor r
Z pytz.tzfiler Z
OLSON_VERSIONZVERSION __version__Z
OLSEN_VERSION__all__ version_infostrZunicoder getenvr- endswithr) r3 r7 r= r r< rJ r; r rW ZHOURr8 r
r\ Z__safe_for_unpickling__rm rn r r} r rM r r r rg r walkr dirsfilesZexcludeindexextendr r/ r' r. Zzonetabr r r r r r s
?
2
8( C
&