{"id":11059,"date":"2025-09-06T06:34:26","date_gmt":"2025-09-06T06:34:26","guid":{"rendered":"https:\/\/www.kaashivinfotech.com\/blog\/?p=11059"},"modified":"2025-09-06T06:34:26","modified_gmt":"2025-09-06T06:34:26","slug":"how-to-use-timedelta-in-python","status":"publish","type":"post","link":"https:\/\/www.kaashivinfotech.com\/blog\/how-to-use-timedelta-in-python\/","title":{"rendered":"How to Use Timedelta in Python to Add and Subtract Dates (2025 Guide)"},"content":{"rendered":"

Working with dates isn\u2019t just about knowing what day it is today. In real projects, developers need to add days to a deadline, subtract hours from a timestamp, or calculate the difference between two events<\/strong>. That\u2019s where timedelta<\/code> in Python<\/strong> comes in.<\/p>\n

In this guide, you\u2019ll learn how the Python timedelta<\/strong> object works, how to create it, and how to use it to perform calculations with dates and times. You\u2019ll also see common errors developers face and best practices to avoid them.<\/p>\n

\n

\ud83d\udd11 Key Highlights<\/h2>\n
    \n
  • Understand what timedelta in Python<\/strong> is and why it matters<\/li>\n
  • Learn how to add days, hours, and minutes<\/strong> to a datetime object<\/li>\n
  • Calculate the difference between two dates<\/strong> in Python<\/li>\n
  • Fix common errors like NameError: name 'timedelta' is not defined<\/code><\/li>\n
  • Real-world examples: subscription billing, project deadlines, log analysis<\/li>\n<\/ul>\n
    \n

    What is timedelta in Python?<\/h2>\n

    The timedelta<\/code> class is part of the datetime module in Python<\/strong>. It represents a duration<\/strong> \u2014 the difference between two dates or times.<\/p>\n

    Think of it as a time span, not a specific date.<\/p>\n

    \ud83d\udc49 Example: 5 days, 4 hours, and 30 minutes.<\/p>\n

    This is how you import it:<\/p>\n

    from datetime import datetime, timedelta\n<\/code><\/pre>\n
    \"What
    What is timedelta in Python<\/figcaption><\/figure>\n
    \n
    How to Create a timedelta Object in Python<\/h2>\n
    A timedelta<\/strong> object can be created by specifying days, hours, minutes, seconds, or microseconds.<\/p>\n
    from datetime import timedelta\r\n\r\ndelta = timedelta(days=5, hours=4, minutes=30)\r\nprint(delta)\r\n# 5 days, 4:30:00\r\n<\/pre>\n
    Here, delta<\/code> represents a time span, not a calendar date.<\/p>\n
    \n
    Adding Days to a Date Using timedelta<\/h2>\n
    A common use case is extending deadlines<\/strong>.<\/p>\n
    from datetime import datetime, timedelta\r\n\r\ntoday = datetime.now()\r\ndeadline = today + timedelta(days=7)\r\n\r\nprint(\"Today:\", today)\r\nprint(\"Deadline:\", deadline)\r\n<\/pre>\n
    \ud83d\udc49 Perfect for project management apps, where you calculate due dates.<\/p>\n
    \n
    Subtracting Dates with timedelta<\/h2>\n
    You can also subtract one datetime from another.<\/p>\n
    from datetime import datetime\r\n\r\nd1 = datetime(2025, 9, 1, 12, 0)\r\nd2 = datetime(2025, 9, 4, 15, 30)\r\n\r\ndiff = d2 - d1\r\nprint(diff)         # 3 days, 3:30:00\r\nprint(diff.days)    # 3\r\nprint(diff.seconds) # 12600 (3.5 hours in seconds)\r\n<\/pre>\n
    This is how you calculate:<\/p>\n