Message106371
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." |
|
Date |
User |
Action |
Args |
2010-05-24 16:20:21 | belopolsky | set | recipients:
+ belopolsky, docs@python |
2010-05-24 16:20:21 | belopolsky | set | messageid: <1274718021.16.0.883294684947.issue8810@psf.upfronthosting.co.za> |
2010-05-24 16:20:18 | belopolsky | link | issue8810 messages |
2010-05-24 16:20:18 | belopolsky | create | |
|