This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author belopolsky
Recipients belopolsky, docs@python
Date 2010-05-24.16:20:18
SpamBayes Score 0.013912417
Marked as misclassified No
Message-id <1274718021.16.0.883294684947.issue8810@psf.upfronthosting.co.za>
In-reply-to
Content
From <http://docs.python.org/dev/py3k/library/datetime.html#datetime.tzinfo.utcoffset>:

"""
tzinfo.utcoffset(self, dt)

    Return offset of local time from UTC, in minutes east of UTC. 
"""

This suggests that the return value is an integer representing the number of minutes.  It is later explained that in fact "the value returned must be a timedelta object specifying a whole number of minutes", but many users won't read past the first sentence.

I suggest s/in minutes east of UTC/as a timedelta object/.  I think "east of UTC" is redundant given the next sentence, "If local time is west of UTC, this should be negative", but that can also be reworded for clarity as "The offset for timezones west of UTC is negative, and for those east of UTC is positive."
History
Date User Action Args
2010-05-24 16:20:21belopolskysetrecipients: + belopolsky, docs@python
2010-05-24 16:20:21belopolskysetmessageid: <1274718021.16.0.883294684947.issue8810@psf.upfronthosting.co.za>
2010-05-24 16:20:18belopolskylinkissue8810 messages
2010-05-24 16:20:18belopolskycreate