From String to datetime

Converting strings to datetime objects is one of the most frequent tasks in Python programming — whether you're processing logs, API responses, CSV files, user input, or database timestamps. Python’s datetime module makes this reliable and flexible, but getting the format right is key to avoiding frustrating errors.

Here’s a practical, step-by-step guide to mastering string-to-datetime conversion in 2026 — with examples, common formats, best practices, and modern alternatives.

Basic Conversion with strptime()

Use datetime.strptime() — it parses a string according to a format string you provide.


from datetime import datetime

date_str = "2026-03-15 14:30:00"
dt = datetime.strptime(date_str, "%Y-%m-%d %H:%M:%S")

print(dt)           # 2026-03-15 14:30:00
print(dt.year)      # 2026
print(dt.weekday()) # 6 (Sunday)

Format codes quick reference:

%Y ? 4-digit year (2026)
%m ? month (01–12)
%d ? day (01–31)
%H ? hour (00–23)
%M ? minute (00–59)
%S ? second (00–59)
%A ? weekday name (Monday)
%B ? month name (March)

Common Format Examples

String Example	Format String
2026-03-15	%Y-%m-%d
03/15/2026	%m/%d/%Y
15 March 2026	%d %B %Y
2026-03-15T14:30:00Z	%Y-%m-%dT%H:%M:%SZ
03-15-2026 2:30 PM	%m-%d-%Y %I:%M %p

Handling Timezones (Modern 2026 Way)

Use zoneinfo (built-in since Python 3.9) for proper timezone support.


from datetime import datetime
from zoneinfo import ZoneInfo

dt_str = "2026-03-15 14:30:00"
dt_naive = datetime.strptime(dt_str, "%Y-%m-%d %H:%M:%S")

# Attach timezone
dt_aware = dt_naive.replace(tzinfo=ZoneInfo("Asia/Karachi"))
print(dt_aware)  # 2026-03-15 14:30:00+05:00

Modern Alternatives (2026 Recommendations)

pendulum — much more intuitive than datetime (highly recommended)
dateutil.parser.parse — auto-detects most formats (no format string needed)
arrow — another human-friendly alternative


# Pendulum example (install: pip install pendulum)
import pendulum

dt = pendulum.parse("2026-03-15 14:30:00 +0500")
print(dt)           # 2026-03-15 14:30:00+05:00
print(dt.in_tz("UTC"))  # converts timezone easily

Common Pitfalls & Best Practices

Always specify encoding='utf-8' when reading files
Use dateutil.parser when format varies
Never trust user input — wrap in try/except
Store dates in UTC internally, convert for display
Avoid naive datetimes in production (always attach tzinfo)

Conclusion

Converting strings to datetime objects is a foundational skill in data processing, APIs, logs, and automation. Master strptime() for strict formats, dateutil.parser for flexibility, and zoneinfo for timezone safety. In 2026, tools like Pendulum make it even easier — but understanding the built-in datetime module gives you full control and portability.