pytz - World Timezone Definitions for Python
============================================
:Author: Stuart Bishop <stuart@stuartbishop.net>
Introduction
~~~~~~~~~~~~
pytz brings the Olson tz database into Python. This library allows
accurate and cross platform timezone calculations using Python 2.3
or higher. It also solves the issue of ambiguous times at the end
of daylight savings, which you can read more about in the Python
Library Reference (datetime.tzinfo).
Amost all (over 540) of the Olson timezones are supported [*]_.
Note that if you perform date arithmetic on local times that cross
DST boundaries, the results may be in an incorrect timezone (ie.
subtract 1 minute from 2002-10-27 1:00 EST and you get 2002-10-27
0:59 EST instead of the correct 2002-10-27 1:59 EDT). This cannot
be resolved without modifying the Python datetime implementation.
However, these tzinfo classes provide a normalize() method which
allows you to correct these values.
Installation
~~~~~~~~~~~~
This is a standard Python distutils distribution. To install the
package, run the following command as an administrative user::
python setup.py install
Example & Usage
~~~~~~~~~~~~~~~
>>> from datetime import datetime, timedelta
>>> from pytz import timezone
>>> import pytz
>>> utc = pytz.utc
>>> utc.zone
'UTC'
>>> eastern = timezone('US/Eastern')
>>> eastern.zone
'US/Eastern'
>>> fmt = '%Y-%m-%d %H:%M:%S %Z%z'
The preferred way of dealing with times is to always work in UTC,
converting to localtime only when generating output to be read
by humans.
>>> utc_dt = datetime(2002, 10, 27, 6, 0, 0, tzinfo=utc)
>>> loc_dt = utc_dt.astimezone(eastern)
>>> loc_dt.strftime(fmt)
'2002-10-27 01:00:00 EST-0500'
This library also allows you to do date arithmetic using local
times, although it is more complicated than working in UTC as you
need to use the `normalize` method to handle daylight savings time
and other timezone transitions. In this example, `loc_dt` is set
to the instant when daylight savings time ends in the US/Eastern
timezone.
>>> before = loc_dt - timedelta(minutes=10)
>>> before.strftime(fmt)
'2002-10-27 00:50:00 EST-0500'
>>> eastern.normalize(before).strftime(fmt)
'2002-10-27 01:50:00 EDT-0400'
>>> after = eastern.normalize(before + timedelta(minutes=20))
>>> after.strftime(fmt)
'2002-10-27 01:10:00 EST-0500'
Creating localtimes is also tricky, and the reason why working with
local times is not recommended. Unfortunately, you cannot just pass
a 'tzinfo' argument when constructing a datetime (see the next section
for more details)
>>> dt = datetime(2002, 10, 27, 1, 30, 0)
>>> dt1 = eastern.localize(dt, is_dst=True)
>>> dt1.strftime(fmt)
'2002-10-27 01:30:00 EDT-0400'
>>> dt2 = eastern.localize(dt, is_dst=False)
>>> dt2.strftime(fmt)
'2002-10-27 01:30:00 EST-0500'
Converting between timezones also needs special attention. This also needs
to use the normalize method to ensure the conversion is correct.
>>> utc_dt = utc.localize(datetime.utcfromtimestamp(1143408899))
>>> utc_dt.strftime(fmt)
'2006-03-26 21:34:59 UTC+0000'
>>> au_tz = timezone('Australia/Sydney')
>>> au_dt = au_tz.normalize(utc_dt.astimezone(au_tz))
>>> au_dt.strftime(fmt)
'2006-03-27 08:34:59 EST+1100'
>>> utc_dt2 = utc.normalize(au_dt.astimezone(utc))
>>> utc_dt2.strftime(fmt)
'2006-03-26 21:34:59 UTC+0000'
You can also take shortcuts when dealing with the UTC side of timezone
conversions. Normalize and localize are not really necessary because there
are no daylight savings time transitions to deal with.
>>> utc_dt = datetime.utcfromtimestamp(1143408899).replace(tzinfo=utc)
>>> utc_dt.strftime(fmt)
'2006-03-26 21:34:59 UTC+0000'
>>> au_tz = timezone('Australia/Sydney')
>>> au_dt = au_tz.normalize(utc_dt.astimezone(au_tz))
>>> au_dt.strftime(fmt)
'2006-03-27 08:34:59 EST+1100'
>>> utc_dt2 = au_dt.astimezone(utc)
>>> utc_dt2.strftime(fmt)
'2006-03-26 21:34:59 UTC+0000'
Problems with Localtime
~~~~~~~~~~~~~~~~~~~~~~~
The major problem we have to deal with is that certain datetimes
may occur twice in a year. For example, in the US/Eastern timezone
on the last Sunday morning in October, the following sequence
happens:
- 01:00 EDT occurs
- 1 hour later, instead of 2:00am the clock is turned back 1 hour
and 01:00 happens again (this time 01:00 EST)
In fact, every instant between 01:00 and 02:00 occurs twice. This means
that if you try and create a time in the US/Eastern timezone using
the standard datetime syntax, there is no way to specify if you meant
before of after the end-of-daylight-savings-time transition.
>>> loc_dt = datetime(2002, 10, 27, 1, 30, 00, tzinfo=eastern)
>>> loc_dt.strftime(fmt)
'2002-10-27 01:30:00 EST-0500'
As you can see, the system has chosen one for you and there is a 50%
chance of it being out by one hour. For some applications, this does
not matter. However, if you are trying to schedule meetings with people
in different timezones or analyze log files it is not acceptable.
The best and simplest solution is to stick with using UTC. The pytz package
encourages using UTC for internal timezone representation by including a
special UTC implementation based on the standard Python reference
implementation in the Python documentation. This timezone unpickles to be
the same instance, and pickles to a relatively small size. The UTC
implementation can be obtained as pytz.utc, pytz.UTC, or
pytz.timezone('UTC'). Note that this instance is not the same
instance (or implementation) as other timezones with the same meaning
(GMT, Greenwich, Universal, etc.).
>>> import pickle, pytz
>>> dt = 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), len(p) - len(naive_p)
(60, 43, 17)
>>> new = pickle.loads(p)
>>> new == dt
True
>>> new is dt
False
>>> new.tzinfo is dt.tzinfo
True
>>> pytz.utc is pytz.UTC is pytz.timezone('UTC')
True
>>> utc is pytz.timezone('GMT')
False
If you insist on working with local times, this library provides a
facility for constructing them almost unambiguously.
>>> loc_dt = datetime(2002, 10, 27, 1, 30, 00)
>>> est_dt = eastern.localize(loc_dt, is_dst=True)
>>> edt_dt = eastern.localize(loc_dt, is_dst=False)
>>> print est_dt.strftime(fmt), '/', edt_dt.strftime(fmt)
2002-10-27 01:30:00 EDT-0400 / 2002-10-27 01:30:00 EST-0500
Note that although this handles many cases, it is still not possible
to handle all. In cases where countries change their timezone definitions,
cases like the end-of-daylight-savings-time occur with no way of resolving
the ambiguity. For example, in 1915 Warsaw switched from Warsaw time to
Central European time. So at the stroke of midnight on August 4th 1915
the clocks were wound back 24 minutes creating a ambiguous time period
that cannot be specified without referring to the timezone abbreviation
or the actual UTC offset.
The 'Standard' Python way of handling all these ambiguities is not to,
such as demonstrated in this example using the US/Eastern timezone
definition from the Python documentation (Note that this implementation
only works for dates between 1987 and 2006 - it is included for tests only!):
>>> from pytz.reference import Eastern # pytz.reference only for tests
>>> dt = datetime(2002, 10, 27, 0, 30, tzinfo=Eastern)
>>> str(dt)
'2002-10-27 00:30:00-04:00'
>>> str(dt + timedelta(hours=1))
'2002-10-27 01:30:00-05:00'
>>> str(dt + timedelta(hours=2))
'2002-10-27 02:30:00-05:00'
>>> str(dt + timedelta(hours=3))
'2002-10-27 03:30:00-05:00'
Notice the first two results? At first glance you might think they are
correct, but taking the UTC offset into account you find that they are
actually two hours appart instead of the 1 hour we asked for.
>>> from pytz.reference import UTC # pytz.reference only for tests
>>> str(dt.astimezone(UTC))
'2002-10-27 04:30:00+00:00'
>>> str((dt + timedelta(hours=1)).astimezone(UTC))
'2002-10-27 06:30:00+00:00'
What is UTC
~~~~~~~~~~~
`UTC` is Univ
没有合适的资源?快使用搜索试试~ 我知道了~
温馨提示
共587个文件
py:574个
txt:6个
pkg-info:2个
资源分类:Python库 所属语言:Python 资源全名:pytz-2006p.tar.gz 资源来源:官方 安装方法:https://lanzao.blog.csdn.net/article/details/101784059
资源推荐
资源详情
资源评论
收起资源包目录
Python库 | pytz-2006p.tar.gz (587个子文件)
setup.cfg 59B
MANIFEST.in 134B
PKG-INFO 3KB
PKG-INFO 3KB
pytz.pot 18KB
__init__.py 28KB
test_tzinfo.py 15KB
tzinfo.py 13KB
Newfoundland.py 10KB
St_Johns.py 10KB
New_York.py 10KB
Chicago.py 10KB
posixrules.py 10KB
Eastern.py 10KB
Central.py 10KB
Montreal.py 10KB
Toronto.py 10KB
Eastern.py 10KB
Atlantic.py 9KB
Halifax.py 9KB
Isle_of_Man.py 9KB
GB_minus_Eire.py 9KB
Guernsey.py 9KB
Belfast.py 9KB
London.py 9KB
Jersey.py 9KB
GB.py 9KB
Azores.py 9KB
Dublin.py 9KB
Eire.py 9KB
Madeira.py 9KB
Lisbon.py 9KB
Portugal.py 9KB
Moncton.py 9KB
Goose_Bay.py 9KB
Vancouver.py 8KB
Pacific.py 8KB
Pacific_minus_New.py 8KB
Los_Angeles.py 8KB
Gibraltar.py 8KB
Pacific.py 8KB
Winnipeg.py 8KB
Central.py 8KB
Louisville.py 7KB
Brussels.py 7KB
Louisville.py 7KB
Monaco.py 7KB
Luxembourg.py 7KB
Amsterdam.py 7KB
Paris.py 7KB
Cairo.py 7KB
Egypt.py 7KB
Istanbul.py 7KB
Istanbul.py 7KB
Turkey.py 7KB
San_Marino.py 7KB
Vatican.py 7KB
Rome.py 7KB
Malta.py 7KB
Warsaw.py 7KB
Continental.py 7KB
Poland.py 7KB
Santiago.py 7KB
Auckland.py 7KB
Madrid.py 7KB
NZ.py 7KB
Shiprock.py 7KB
Denver.py 7KB
Mountain.py 7KB
Navajo.py 7KB
Indiana_minus_Starke.py 7KB
Havana.py 7KB
Edmonton.py 7KB
Mountain.py 7KB
Cuba.py 7KB
Knox.py 7KB
Knox_IN.py 7KB
EasterIsland.py 6KB
BajaNorte.py 6KB
Ensenada.py 6KB
Tijuana.py 6KB
New_Salem.py 6KB
PST8PDT.py 6KB
Anchorage.py 6KB
Easter.py 6KB
Center.py 6KB
Boise.py 6KB
Damascus.py 6KB
Alaska.py 6KB
Tasmania.py 6KB
Nassau.py 6KB
Hobart.py 6KB
Aleutian.py 6KB
Adak.py 6KB
Atka.py 6KB
Nome.py 6KB
MST7MDT.py 6KB
CST6CDT.py 6KB
EST5EDT.py 6KB
Budapest.py 6KB
共 587 条
- 1
- 2
- 3
- 4
- 5
- 6
资源评论
挣扎的蓝藻
- 粉丝: 12w+
- 资源: 15万+
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功