[docs] [issue9305] Don't use east/west of UTC in date/time documentation
anatoly techtonik
techtonik at gmail.com
Tue Jul 20 16:46:10 CEST 2010
On Mon, Jul 19, 2010 at 7:21 PM, Alexander Belopolsky
<report at bugs.python.org> wrote:
>
> I suggest the following wording for time.timezone description:
>
> time.timezone: The number of seconds one must add to the local time to arrive at UTC.
Makes sense. I can't see any other real explanation for -7200 value if
I am in +2 UTC timezone.
> Similarly, tzinfo.utcoffset() can be defined as "Returns timedelta one must add to UTC to arrive at local time."
I believe the correct convention is "Return timedelta...". Another
concern - if UTC is 0 reference point then there is no reason to add
something to it - you just can say - "Return timedelta equal to local
UTC offset."
More information about the docs
mailing list