Datetime Module in Python0%

Datetime Module in Python

Intermediate8 min read•Updated: 2026-10-01

The Datetime Module in Python

Date and time manipulation is central to backend systems, financial transaction logs, scheduling engines, and data analytics. Python's built-in datetime module provides classes for managing calendar dates, times, durations, and timezones.

1. The Core `datetime` Classes

The module is structured into four primary classes:

date: Represents an idealized calendar date (Year, Month, Day).
time: Represents an idealized time of day (Hour, Minute, Second, Microsecond), independent of any date.
datetime: Combines both date and time into a single timestamp.
timedelta: Represents a duration expressing the difference between two dates or times.

1from datetime import date, time, datetime, timedelta, timezone
2 
3# 1. Date instance
4today = date.today()
5print(f"Today: {today.year}-{today.month:02d}-{today.day:02d}")
6 
7# 2. Time instance
8lunch_time = time(13, 30, 0)  # 01:30:00 PM
9print(f"Lunch: {lunch_time}")
10 
11# 3. Datetime instance
12now = datetime.now()
13print(f"Current local timestamp: {now}")
14 
15# 4. Timezone-Aware UTC Timestamp (Python 3.11+ recommended)
16utc_now = datetime.now(timezone.utc)
17print(f"Current UTC timestamp: {utc_now}")

2. Formatting Dates with `strftime()`

The strftime() method (String Format Time) converts a datetime object into a custom formatted string according to format directives:

Directive	Meaning	Example Output
`%Y`	4-digit Year	`2026`
`%m`	2-digit Month (01-12)	`09`
`%d`	2-digit Day of Month (01-31)	`12`
`%H`	Hour in 24-hour clock (00-23)	`16`
`%I`	Hour in 12-hour clock (01-12)	`04`
`%M`	Minute (00-59)	`15`
`%S`	Second (00-59)	`30`
`%p`	AM / PM	`PM`
`%B`	Full Month Name	`September`
`%A`	Full Weekday Name	`Saturday`

1from datetime import datetime
2 
3current = datetime.now()
4 
5# Standard formats:
6print(current.strftime("%d-%m-%Y %H:%M:%S"))      # 12-09-2026 16:15:30
7print(current.strftime("%A, %B %d, %Y"))          # Saturday, September 12, 2026
8print(current.strftime("%I:%M %p"))                # 04:15 PM
9print(current.isoformat())                        # 2026-09-12T16:15:30.123456

3. Parsing Strings into Dates with `strptime()`

The strptime() method (String Parse Time) converts text strings from files, databases, or APIs into datetime objects using the corresponding format string:

1from datetime import datetime
2 
3date_str = "2026-09-12 18:45"
4parsed_dt = datetime.strptime(date_str, "%Y-%m-%d %H:%M")
5 
6print(parsed_dt)        # 2026-09-12 18:45:00
7print(type(parsed_dt))  # <class 'datetime.datetime'>
8print("Year:", parsed_dt.year)

Memory Trick: - strftime -> Format to string. - strptime -> Parse from string.

4. Date Arithmetic with `timedelta`

timedelta allows calculating deadlines, age, past dates, and future intervals effortlessly:

1from datetime import datetime, timedelta
2 
3now = datetime.now()
4 
5# Calculate future deadline (14 days and 4 hours ahead)
6trial_duration = timedelta(days=14, hours=4)
7expiry_date = now + trial_duration
8print(f"Subscription expires on: {expiry_date.strftime('%Y-%m-%d %H:%M')}")
9 
10# Calculating difference between two dates
11epoch_event = datetime(2026, 1, 1)
12elapsed = now - epoch_event
13print(f"Days elapsed since New Year 2026: {elapsed.days} days")
14print(f"Total seconds elapsed: {elapsed.total_seconds():,.0f} s")

5. Naive vs. Aware Datetime Objects

Naive: Contains no timezone information. Python cannot determine what geographical timezone it belongs to.
Aware: Holds timezone metadata (such as UTC, IST, or EST) via the tzinfo parameter, preventing ambiguity across distributed servers.

1from datetime import datetime, timezone, timedelta
2 
3# Create timezone offset (IST: UTC + 5:30)
4ist_zone = timezone(timedelta(hours=5, minutes=30), name="IST")
5 
6# Current time in IST
7ist_time = datetime.now(ist_zone)
8print(f"Time in India: {ist_time}")
9# Output: 2026-09-12 16:15:30.123456+05:30

⚠️ Common Intermediate Mistakes & Gotchas

1. Confusing Naive and Aware Datetimes

A naive datetime object has no timezone (tzinfo=None). Comparing a naive datetime with a timezone-aware datetime raises a TypeError. In modern Python (3.11+), use datetime.now(timezone.utc).

2. Mixing up `%m` (Month) and `%M` (Minute)

In strftime format strings:

%m: 2-digit month (01–12)
%M: 2-digit minute (00–59)

💻 Try It Yourself: Days Until Next Birthday Calculator

Scenario

Write a function that calculates the exact number of days remaining until your next birthday using datetime.date and timedelta.

Complete Solution

1from datetime import date
2 
3def days_until_birthday(birth_month: int, birth_day: int) -> int:
4    today = date.today()
5    this_year_bday = date(today.year, birth_month, birth_day)
6    
7    if this_year_bday < today:
8        next_bday = date(today.year + 1, birth_month, birth_day)
9    else:
10        next_bday = this_year_bday
11        
12    return (next_bday - today).days
13 
14# Example calculation
15days = days_until_birthday(12, 25)
16print(f"Days until December 25th: {days} days")

Expected Output

1Days until December 25th: 85 days

Interactive Quiz• Knowledge Check

Practice Quiz

Question 1

Which method converts a datetime object into a custom formatted string?

Question 2

What does strptime("25/12/2026", "%d/%m/%Y") produce?

Question 3

Which class represents the elapsed duration or difference between two datetime instances?

Question 4

What is the difference between a "naive" and an "aware" datetime object in Python?

Question 5

What directive in strftime() represents the 4-digit year?

🚀 What's Next?

In the next lesson, we will continue your intermediate Python journey with Collections Module (10: Python Standard Libraries).

👉 Continue to Next Lesson: Collections Module →

Next Lesson

Collections Module

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Math and Random Module	Collections Module

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

PreviousPrevNext

MSK Institute • Shikohabad

Loading Page Content...

Preparing courses, live labs, and learning resources.सामग्री लोड हो रही है, कृपया प्रतीक्षा करें...

Connecting serverPlease wait...

💻 Practical Labs🚀 Free Demo📜 Verified Certificates

Collections Module

Datetime Module in Python

Intermediate8 min read•Updated: 2026-10-01

Study Materials Cheatsheet

The Datetime Module in Python

1. The Core `datetime` Classes

The module is structured into four primary classes:

date: Represents an idealized calendar date (Year, Month, Day).
time: Represents an idealized time of day (Hour, Minute, Second, Microsecond), independent of any date.
datetime: Combines both date and time into a single timestamp.
timedelta: Represents a duration expressing the difference between two dates or times.

1from datetime import date, time, datetime, timedelta, timezone
2 
3# 1. Date instance
4today = date.today()
5print(f"Today: {today.year}-{today.month:02d}-{today.day:02d}")
6 
7# 2. Time instance
8lunch_time = time(13, 30, 0)  # 01:30:00 PM
9print(f"Lunch: {lunch_time}")
10 
11# 3. Datetime instance
12now = datetime.now()
13print(f"Current local timestamp: {now}")
14 
15# 4. Timezone-Aware UTC Timestamp (Python 3.11+ recommended)
16utc_now = datetime.now(timezone.utc)
17print(f"Current UTC timestamp: {utc_now}")

2. Formatting Dates with `strftime()`

The strftime() method (String Format Time) converts a datetime object into a custom formatted string according to format directives:

Directive	Meaning	Example Output
`%Y`	4-digit Year	`2026`
`%m`	2-digit Month (01-12)	`09`
`%d`	2-digit Day of Month (01-31)	`12`
`%H`	Hour in 24-hour clock (00-23)	`16`
`%I`	Hour in 12-hour clock (01-12)	`04`
`%M`	Minute (00-59)	`15`
`%S`	Second (00-59)	`30`
`%p`	AM / PM	`PM`
`%B`	Full Month Name	`September`
`%A`	Full Weekday Name	`Saturday`

1from datetime import datetime
2 
3current = datetime.now()
4 
5# Standard formats:
6print(current.strftime("%d-%m-%Y %H:%M:%S"))      # 12-09-2026 16:15:30
7print(current.strftime("%A, %B %d, %Y"))          # Saturday, September 12, 2026
8print(current.strftime("%I:%M %p"))                # 04:15 PM
9print(current.isoformat())                        # 2026-09-12T16:15:30.123456

3. Parsing Strings into Dates with `strptime()`

The strptime() method (String Parse Time) converts text strings from files, databases, or APIs into datetime objects using the corresponding format string:

1from datetime import datetime
2 
3date_str = "2026-09-12 18:45"
4parsed_dt = datetime.strptime(date_str, "%Y-%m-%d %H:%M")
5 
6print(parsed_dt)        # 2026-09-12 18:45:00
7print(type(parsed_dt))  # <class 'datetime.datetime'>
8print("Year:", parsed_dt.year)

Memory Trick: - strftime -> Format to string. - strptime -> Parse from string.

4. Date Arithmetic with `timedelta`

timedelta allows calculating deadlines, age, past dates, and future intervals effortlessly:

1from datetime import datetime, timedelta
2 
3now = datetime.now()
4 
5# Calculate future deadline (14 days and 4 hours ahead)
6trial_duration = timedelta(days=14, hours=4)
7expiry_date = now + trial_duration
8print(f"Subscription expires on: {expiry_date.strftime('%Y-%m-%d %H:%M')}")
9 
10# Calculating difference between two dates
11epoch_event = datetime(2026, 1, 1)
12elapsed = now - epoch_event
13print(f"Days elapsed since New Year 2026: {elapsed.days} days")
14print(f"Total seconds elapsed: {elapsed.total_seconds():,.0f} s")

5. Naive vs. Aware Datetime Objects

Naive: Contains no timezone information. Python cannot determine what geographical timezone it belongs to.
Aware: Holds timezone metadata (such as UTC, IST, or EST) via the tzinfo parameter, preventing ambiguity across distributed servers.

1from datetime import datetime, timezone, timedelta
2 
3# Create timezone offset (IST: UTC + 5:30)
4ist_zone = timezone(timedelta(hours=5, minutes=30), name="IST")
5 
6# Current time in IST
7ist_time = datetime.now(ist_zone)
8print(f"Time in India: {ist_time}")
9# Output: 2026-09-12 16:15:30.123456+05:30

⚠️ Common Intermediate Mistakes & Gotchas

1. Confusing Naive and Aware Datetimes

A naive datetime object has no timezone (tzinfo=None). Comparing a naive datetime with a timezone-aware datetime raises a TypeError. In modern Python (3.11+), use datetime.now(timezone.utc).

2. Mixing up `%m` (Month) and `%M` (Minute)

In strftime format strings:

%m: 2-digit month (01–12)
%M: 2-digit minute (00–59)

💻 Try It Yourself: Days Until Next Birthday Calculator

Scenario

Write a function that calculates the exact number of days remaining until your next birthday using datetime.date and timedelta.

Complete Solution

1from datetime import date
2 
3def days_until_birthday(birth_month: int, birth_day: int) -> int:
4    today = date.today()
5    this_year_bday = date(today.year, birth_month, birth_day)
6    
7    if this_year_bday < today:
8        next_bday = date(today.year + 1, birth_month, birth_day)
9    else:
10        next_bday = this_year_bday
11        
12    return (next_bday - today).days
13 
14# Example calculation
15days = days_until_birthday(12, 25)
16print(f"Days until December 25th: {days} days")

Expected Output

1Days until December 25th: 85 days

Interactive Quiz• Knowledge Check

Practice Quiz

Question 1

Which method converts a datetime object into a custom formatted string?

Question 2

What does strptime("25/12/2026", "%d/%m/%Y") produce?

Question 3

Which class represents the elapsed duration or difference between two datetime instances?

Question 4

What is the difference between a "naive" and an "aware" datetime object in Python?

Question 5

What directive in strftime() represents the 4-digit year?

🚀 What's Next?

In the next lesson, we will continue your intermediate Python journey with Collections Module (10: Python Standard Libraries).

👉 Continue to Next Lesson: Collections Module →

Next Lesson

Collections Module

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Math and Random Module	Collections Module

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

The Datetime Module in Python

1. The Core datetime Classes

2. Formatting Dates with strftime()

3. Parsing Strings into Dates with strptime()

4. Date Arithmetic with timedelta

5. Naive vs. Aware Datetime Objects

⚠️ Common Intermediate Mistakes & Gotchas

1. Confusing Naive and Aware Datetimes

2. Mixing up %m (Month) and %M (Minute)

💻 Try It Yourself: Days Until Next Birthday Calculator

Scenario

Complete Solution

Expected Output

Practice Quiz

🚀 What's Next?

Collections Module

Related Lessons

Practice Quiz

Loading Page Content...

The Datetime Module in Python

1. The Core datetime Classes

2. Formatting Dates with strftime()

3. Parsing Strings into Dates with strptime()

4. Date Arithmetic with timedelta

5. Naive vs. Aware Datetime Objects

⚠️ Common Intermediate Mistakes & Gotchas

1. Confusing Naive and Aware Datetimes

2. Mixing up %m (Month) and %M (Minute)

💻 Try It Yourself: Days Until Next Birthday Calculator

Scenario

Complete Solution

Expected Output

Practice Quiz

🚀 What's Next?

Collections Module

Related Lessons

Practice Quiz

1. The Core `datetime` Classes

2. Formatting Dates with `strftime()`

3. Parsing Strings into Dates with `strptime()`

4. Date Arithmetic with `timedelta`

2. Mixing up `%m` (Month) and `%M` (Minute)

1. The Core `datetime` Classes

2. Formatting Dates with `strftime()`

3. Parsing Strings into Dates with `strptime()`

4. Date Arithmetic with `timedelta`

2. Mixing up `%m` (Month) and `%M` (Minute)