← Back to Articles
Tutorial

Understanding Python Timedelta

Learn about Python timedelta, its uses, examples, and common pitfalls.

Python's timedelta is a part of the datetime module and is used to represent the difference between two dates or times. It is a powerful tool for performing date arithmetic and managing temporal data effectively.

The timedelta object represents a duration, the difference between two dates or times. For example, you can create a timedelta object representing 5 days with `timedelta(days=5)`. This can be added to a datetime object to get a future date or subtracted to get a past date.

When working with timedelta, consider using meaningful variable names to enhance code readability. Always check for timezone differences when performing date arithmetic across different time zones.

A common mistake is assuming that timedelta accounts for daylight saving time changes, which it does not. Always handle such cases separately to avoid incorrect time calculations.

Code Examples

Example 1

from datetime import datetime, timedelta

now = datetime.now()
future_date = now + timedelta(days=10)
print(future_date)

Example 2

from datetime import timedelta

time_span = timedelta(weeks=2, days=3, hours=4)
print(time_span.total_seconds())

More Python Tutorials