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.

Title: Allow timezone offsets greater than 24 hours
Type: enhancement Stage: resolved
Components: Library (Lib) Versions:
Status: closed Resolution: third party
Dependencies: Superseder: tzinfo objects with sub-minute offsets are not supported (e.g. UTC+05:53:28)
View: 5288
Assigned To: Nosy List: belopolsky, tim.peters, tjhnson
Priority: normal Keywords:

Created on 2015-09-01 14:31 by tjhnson, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Messages (5)
msg249482 - (view) Author: TJ (tjhnson) Date: 2015-09-01 14:31
The datetime module only supports timezone offsets within 24 hours of UTC:

This seems like an arbitrary restriction, and prevents the library from being used in arbitrary timezone translations. For various reasons, one might need to start a new day (perhaps to implement some business logic) during the regular day. Depending on when/where this is, the effective offset can easily be greater than 24 hours.

>>> import datetime
>>> import pytz

>>> dt = pytz.utc.localize(datetime.datetime.utcnow())
>>> dt
datetime.datetime(2015, 8, 31, 23, 30, 55, 590037, tzinfo=<UTC>)

>>> tz = pytz.timezone('Pacific/Auckland_Custom')
>>> dt.astimezone(tz)
datetime.datetime(2015, 9, 2, 4, 30, 55, 590037, tzinfo=<DstTzInfo 'Pacific/Auckland_Custom' NZST+1 day, 5:00:00 STD>)

>>> dt_local =
>>> tz.localize(dt_local)
.../python2.7/site-packages/pytz/ in localize(self, dt, is_dst)
    314 loc_dt = tzinfo.normalize(dt.replace(tzinfo=tzinfo))
    315 if loc_dt.replace(tzinfo=None) == dt:
--> 316 possible_loc_dt.add(loc_dt)
    318 if len(possible_loc_dt) == 1:

ValueError: tzinfo.utcoffset() returned 1440; must be in -1439 .. 1439

Note that although only offsets within 24 hours are supported, it seems to be possible to use astimezone() with arbitrary offsets. So perhaps we gain consistency in removing the restriction altogether?

This would not be unprecedented. RFC 2822 allows any offset
representable as HHMM: "the zone MUST be within the range -9959
through +9959" Section 3.3 of
msg249555 - (view) Author: Alexander Belopolsky (belopolsky) * (Python committer) Date: 2015-09-02 16:23
The timezone offset range restriction is not arbitrary.  It was discussed in issue 5094 (see msg107059 and responses to it.)

Nevertheless, there is an open proposal to remove all restrictions on offset values and allow it to be an arbitrary timedelta.  See issue 5288, msg248468.

I think we should consolidate this issue with #5288.
msg249557 - (view) Author: Alexander Belopolsky (belopolsky) * (Python committer) Date: 2015-09-02 16:29
BTW, the specific issue that OP complains about is not a datetime issue: apparently pytz has an even tighter restriction on timezone offsets.

I am going to close this as a third party issues, but those who support relaxing datetime.timezone restriction to ±24h range are invited to participate in issue 5288 discussion.
msg249676 - (view) Author: TJ (tjhnson) Date: 2015-09-03 17:05
Thanks for the pointer to #5288. Happy to consolidate there.

In my reading of #5094 (from which I pulled your RFC 2822 reference), the justification I found was "For the allowable range, follow the datetime docs as someone might be relying on that specification already".  But this didn't explain why it was in the spec in the first place, and that is the decision I thought was arbitrary, not the decision to maintain the restriction. Splitting hairs at this point. Looking forward to the restriction being removed.
msg249677 - (view) Author: Alexander Belopolsky (belopolsky) * (Python committer) Date: 2015-09-03 17:11
I always thought that restriction came from ISO 8601, but at the moment I don't have it to check.
Date User Action Args
2022-04-11 14:58:20adminsetgithub: 69167
2015-09-03 17:11:50belopolskysetmessages: + msg249677
2015-09-03 17:05:56tjhnsonsetmessages: + msg249676
2015-09-02 16:29:29belopolskysetstatus: open -> closed
resolution: third party
messages: + msg249557

superseder: tzinfo objects with sub-minute offsets are not supported (e.g. UTC+05:53:28)
stage: resolved
2015-09-02 16:23:10belopolskysetnosy: + tim.peters
messages: + msg249555
2015-09-02 08:31:06berker.peksagsetnosy: + belopolsky
2015-09-01 14:31:14tjhnsoncreate