[Python-Dev] cpython (2.7): Issue #14448: mention pytz; patch by Andrew Svetlov
sandro.tosi at gmail.com
Wed Apr 25 19:21:30 CEST 2012
On Wed, Apr 25, 2012 at 11:55, Nick Coghlan <ncoghlan at gmail.com> wrote:
> On Wed, Apr 25, 2012 at 6:21 PM, Sandro Tosi <sandro.tosi at gmail.com> wrote:
>> On Wed, Apr 25, 2012 at 09:37, Georg Brandl <g.brandl at gmx.net> wrote:
>>> Also, I'm not sure everybody knows what the "Olson database" is, so maybe that
>>> should be explained too.
>> I had considered that, but then I found another reference of "Olson
>> database" in an example right before the seealso note, so I left it as
>> it is. On a second thought, it might be better to clarify what Olson
>> db is, do you think a link (f.e to here:
>> http://www.iana.org/time-zones ) could be enough or (or in addition)
>> also a brief note is needed?
> I think another "see also" with a link to that page would be
> appropriate. With maintenance of the database transferred to the IANA,
> I'd also rephrase the reference as the "IANA timezone database (also
> known as the Olson database)"
Ah yes, I like that; what about this change (where the IANA tz db
section is brutally copied from their website):
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
@@ -1524,12 +1524,19 @@
- The Standard Library has no :class:`tzinfo` instances except for UTC, but
- it exists a third-party library which brings Olson timezone database to
- Python: `pytz`.
+ The standard library has no :class:`tzinfo` instances except for UTC, but
+ there exists a third-party library which brings the `IANA timezone
+ database` (also known as the Olson database) to Python: `pytz`.
`pytz` contains up-to-date information and its usage is recommended.
+ `IANA timezone database <http://www.iana.org/time-zones>`_
+ The Time Zone Database (often called tz or zoneinfo) contains code and
+ data that represent the history of local time for many representative
+ locations around the globe. It is updated periodically to reflect changes
+ made by political bodies to time zone boundaries, UTC offsets, and
+ daylight-saving rules.
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi
More information about the Python-Dev