Comprehensive Guide to Python Time Handling: time, datetime, pytz, dateutil, and Arrow

Python's time handling starts with basic concepts such as the definition of a second, GMT, UTC, time zones, and leap seconds, which form the foundation for all subsequent modules.

time module : Provides functions like time.time() , time.ctime() , time.localtime() , time.gmtime() , and conversion utilities such as time.mktime() and time.strftime() . It also includes timer functions time.sleep() and time.clock() , and attributes like time.timezone and time.tzname .

<code>import time
print(time.time())
print(time.ctime())
print(time.localtime())
print(time.gmtime())
</code>

datetime module : Offers immutable classes date , time , datetime , timedelta , and tzinfo . It supports creation, formatting ( strftime ), parsing ( strptime ), arithmetic, and timezone‑aware objects via tzinfo subclasses.

<code>from datetime import datetime, date, timedelta
print(datetime.now())
print(date.today())
print(timedelta(days=5))
</code>

pytz : Handles time‑zone conversions and daylight‑saving time using the Olson database. Example shows converting naive local time to an aware object and switching between zones like Asia/Shanghai and Asia/Urumqi.

<code>import pytz
tz = pytz.timezone('Asia/Shanghai')
aware = tz.localize(datetime.now())
print(aware)
print(aware.astimezone(pytz.utc))
</code>

dateutil : Provides robust parsing with parser.parse() and recurrence rules via rrule . It can interpret many date string formats and generate sequences of dates.

<code>from dateutil import parser, rrule
print(parser.parse('8th March,2004'))
for dt in rrule.rrule(rrule.DAILY, count=5, dtstart=datetime.now()):
    print(dt)
</code>

Arrow : A high‑level library that simplifies creation, conversion, formatting, and human‑friendly output of dates and times. It supports UTC/local conversion, timezone shifting, humanized differences, and formatting patterns.

<code>import arrow
now = arrow.now()
print(now.format('YYYY-MM-DD HH:mm:ss'))
print(now.shift(hours=-3).humanize())
</code>

ISO 8601 : The international standard for date‑time representation. Python can parse ISO strings with dateutil.parser or datetime.strptime , and format them using strftime or Arrow's format method.

<code>from dateutil import parser
print(parser.parse('2008-09-03T20:56:35.450686Z'))
</code>

Overall, the guide equips developers with the knowledge to work with timestamps, perform conversions, handle time zones, and produce readable date‑time strings across a variety of Python libraries.