{"id":2110,"date":"2020-01-04T11:46:28","date_gmt":"2020-01-04T11:46:28","guid":{"rendered":"https:\/\/www.askpython.com\/?p=2110"},"modified":"2023-05-19T12:00:25","modified_gmt":"2023-05-19T12:00:25","slug":"python-pytz-module","status":"publish","type":"post","link":"https:\/\/www.askpython.com\/python-modules\/python-pytz-module","title":{"rendered":"Python pytz Module: Mastering Timezones in Python\u00a0"},"content":{"rendered":"\n

Python offers many useful libraries and modules to simplify coding. One such module that stands out for handling date and time data is pytz.\u00a0It accounts for daylight saving time, enabling precise date-time conversions. As developers, it saves us the trouble of manual time calculations. It also supports a wide range of timezones, making it ideal for applications with a diverse user base.<\/p>\n\n\n\n

This module is particularly useful when working with databases stored in Coordinated Universal Time (UTC) but requiring conversions to local times for display. Understanding how to effectively use pytz can greatly enhance your Python applications, especially those dealing with time-sensitive data.<\/p>\n\n\n\n

The pytz module’s versatility and functionality allow it to shine in enabling accurate timezone handling in Python software. By simplifying timezone management for developers and providing local time data for international users, pytz makes a valuable addition to any Python developer’s toolkit<\/p>\n\n\n\n

Also read: Python time module<\/a><\/strong><\/em><\/p>\n\n\n\n

How to Install the Python pytz Module for Better Date-Time Handling<\/h2>\n\n\n\n
\n

The Python pytz module<\/strong> offers a comprehensive set of functions and variables to handle date-time conversions across various timezones. The module provides a list or set of all supported timezones, commonly used timezones, country names, and country timezones. The pytz.timezone() function can fetch the current time of a specified timezone.<\/p>\n<\/blockquote>\n\n\n\n

By running the ‘pip install pytz’ command, you can easily install the pytz module in your Python environment.<\/p>\n\n\n

\npip install pytz\n<\/pre><\/div>\n\n\n
\"Pytz
Verifying Your Installation of the pytz Module<\/figcaption><\/figure>\n\n\n\n
\n\n\n\n
Dive into the Core Functions and Variables of the Python pytz Module<\/h2>\n\n\n\n
Let’s now go ahead and explore the different methods and variables of the pytz module.<\/p>\n\n\n\n
\n\n\n\n
1. Exploring Global Timezones with all_timezones and all_timezones_set<\/h3>\n\n\n\n
The all_timezones function of the pytz module returns a list of all the time-zones supported by Python’s pytz module.<\/p>\n\n\n\n
Example:<\/strong><\/p>\n\n\n
\nimport pytz\n\nprint('The timezones supported by pytz module: ', pytz.all_timezones, '\\n')\n<\/pre><\/div>\n\n\n
Output Snippet:<\/strong><\/p>\n\n\n\n
The timezones supported by pytz module:  ['Africa\/Abidjan', 'Africa\/Accra', 'Africa\/Addis_Ababa', 'Africa\/Algiers', 'Africa\/Asmara', 'Africa\/Asmera', 'Africa\/Bamako', 'Africa\/Bangui', 'Africa\/Banjul']<\/code><\/pre>\n\n\n\n
We have shown only a few values because the actual list is very long.<\/p>\n\n\n\n
\n\n\n\n
This variable returns a set of all the supported timezones.<\/p>\n\n\n\n
Example:<\/strong><\/p>\n\n\n
\nimport pytz\nprint('List of supported timezones by pytz module: ', pytz.all_timezones_set, '\\n')\n\n<\/pre><\/div>\n\n\n
Output Snippet:<\/strong><\/p>\n\n\n
\nList of supported timezones by pytz module:  LazySet({'America\/Port-au-Prince', 'Asia\/Ust-Nera', 'Asia\/Vientiane', 'Australia\/Hobart', 'Asia\/Ulaanbaatar', 'Africa\/Lome'})\n<\/pre><\/div>\n\n\n
\n\n\n\n
Also read: Difference between two dates in Python<\/a><\/em><\/strong><\/p>\n\n\n\n
2. Common Timezones Using common_timezones and common_timezones_set<\/h3>\n\n\n\n
This variable returns a list of commonly used time-zones.<\/p>\n\n\n\n
Example:<\/strong><\/p>\n\n\n
\nimport pytz\n\nprint('Commonly used time-zones: ', pytz.common_timezones, '\\n')\n<\/pre><\/div>\n\n\n
Output Snippet:<\/strong><\/p>\n\n\n
\nCommonly used time-zones:  ['Africa\/Abidjan', 'Africa\/Accra', 'Africa\/Addis_Ababa', 'Africa\/Algiers', 'Africa\/Asmara', 'Africa\/Bamako', 'Africa\/Bangui', 'Africa\/Banjul', 'US\/Pacific', 'UTC']\n<\/pre><\/div>\n\n\n
\n\n\n
\nimport pytz\nprint('common_timezones_set() = ', pytz.common_timezones_set, '\\n')\n\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n\n
common_timezones_set() =  LazySet({'America\/Eirunepe', 'Africa\/Kinshasa', 'Australia\/Sydney', 'Europe\/Malta', 'America\/Tortola', 'Canada\/Pacific', 'America\/Argentina\/Cordoba'})<\/code><\/pre>\n\n\n\n
\n\n\n\n
3. Understanding the Time in Different Zones Using pytz.timezone() in Python<\/h3>\n\n\n\n
The pytz.timezone()<\/code> returns the timezone object by the name. And, the datetime.now()<\/code> returns the date-time of that particular time-zone.<\/p>\n\n\n
\nfrom datetime import datetime\nimport pytz\n# getting utc timezone\nutc_time = pytz.utc\n\n# getting timezone by name\nist_time = pytz.timezone('Asia\/Kolkata')\n\n# getting datetime of specified timezone\nprint('Datetime of UTC Time-zone: ', datetime.now(tz=utc_time))\nprint('Datetime of IST Time-zone: ', datetime.now(tz=ist_time))\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\nDatetime of UTC Time-zone:  2020-01-03 17:49:14.220167+00:00\nDatetime of IST Time-zone:  2020-01-03 23:19:14.220167+05:30\n<\/pre><\/div>\n\n\n
\n\n\n\n
4. Decode Country Names with Python’s pytz Module: country_names<\/h3>\n\n\n\n
The country_names<\/code> returns a dictionary<\/a> of country ISO Alpha-2 Code and country name as a key-value pair.<\/p>\n\n\n
\nimport pytz\n\nprint('country_names =')\nfor key, val in pytz.country_names.items():\n    print(key, '=', val, end=',')\nprint('\\n')\nprint('Country name equivalent to the input country code: ', pytz.country_names['AQ'])\n\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\ncountry_names =\nAD = Andorra,AE = United Arab Emirates,AF = Afghanistan,AG = Antigua &amp; Barbuda,AI = Anguilla,AL = Albania,AM = Armenia,AO = Angola,AQ = Antarctica,ZW = Zimbabwe,\nCountry name equivalent to the input country code:  Antarctica\n<\/pre><\/div>\n\n\n
\n\n\n\n
5. Using country_timezones to find time data from across different parts fo the world<\/h3>\n\n\n\n
This function provides a dictionary of country ISO Alpha-2 Code as key and list of supported time-zones for a particular input key (country code) as output.<\/p>\n\n\n
\nimport pytz\nprint('country_timezones =')\nfor key, val in pytz.country_timezones.items():\n    print(key, '=', val, end=',')\nprint('\\n')\nprint('Time-zones supported by Antartica =', pytz.country_timezones['AQ'])\n\n<\/pre><\/div>\n\n\n
Output:<\/strong><\/p>\n\n\n
\ncountry_timezones =\nAD = ['Europe\/Andorra'],AE = ['Asia\/Dubai'],AF = ['Asia\/Kabul'],AG = ['America\/Antigua'],AI = ['America\/Anguilla'],AL = ['Europe\/Tirane'],AM = ['Asia\/Yerevan'],AO = ['Africa\/Luanda'],ZW = ['Africa\/Harare'],\nTime-zones supported by Antartica = ['Antarctica\/McMurdo', 'Antarctica\/Casey', 'Antarctica\/Davis', 'Antarctica\/DumontDUrville', 'Antarctica\/Mawson', 'Antarctica\/Palmer']\n<\/pre><\/div>\n\n\n
\n\n\n\n
Conclusion<\/h2>\n\n\n\n
The Python pytz module is an incredibly powerful tool when dealing with date and time across different timezones. With it, managing time in your Python applications becomes a breeze. After all, in the digital age, isn’t time one of our most precious resources?<\/em><\/p>\n\n\n\n
References<\/h2>\n\n\n\n