README.md

pytzsub

World timezone definitions by country subdivision (e.g., provinces or states)

Accuracy of the database

The database is not authoritative, and it surely has errors. Corrections are welcome and encouraged.

Installation

As per usual:

pip install pytzsub

Examples

>>> from pytzsub import sub_timezone
>>> sub_timezone('US-CA')
'America/Los_Angeles'

>>> from pytzsub import all_code
>>> 'US-CA' in all_code()
True

>>> from pytzsub import sub_timezone
>>> from pytz import timezone
>>> tz = timezone(sub_timezone('CA-QC'))
>>> type(tz)
<class 'pytz.tzfile.America/Toronto'>

Links

• Time Zone Database https://www.iana.org/time-zones
• ISO_3166-2 https://en.wikipedia.org/wiki/ISO_3166-2