Time Module in Python

4 min read
Arya Sarkar

Python provides the time module, which offers numerous functions and classes to effectively handle time-related operations. In this article, we will explore the time module in Python, understand its key features, and demonstrate practical examples of its usage.

Importing the Time Module in Python

To begin utilizing the time module in Python, we first need to import it into our program. This can be accomplished using the following line of code:

import time

Measuring Execution Time in Python

One common use case for the time module is measuring the execution time of a piece of code. The time module provides the time() function, which returns the current time in seconds since the epoch (January 1, 1970, 00:00:00 UTC). We can capture the starting and ending timestamps and calculate the time difference to determine the execution time:

import time

start_time = time.time()

# Code to measure execution time

end_time = time.time()
execution_time = end_time - start_time

print("Execution time:", execution_time, "seconds")

Pausing Execution of Program

The time module allows us to pause the execution of a program for a specific duration. The sleep() function suspends the program for the given number of seconds. Here’s an example that demonstrates pausing the program for 2 seconds:

import time

print("Before sleep")
print("After sleep")

Formatting Time in Python

The time module provides the strftime() function, which allows us to format time values according to a specific format string. The format string consists of various directives that represent different components of time. Here’s an example that displays the current date and time in a specific format:

import time

current_time = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
print("Current time:", current_time)

Converting Time Strings to Timestamps in Python

We often need to convert time strings to timestamps for comparison or arithmetic operations. The strptime() function in the time module allows us to convert a formatted string to a timestamp. The format string must match the structure of the time string. Here’s an example that demonstrates the conversion:

import time

time_string = "2023-06-28 10:30:00"
timestamp = time.strptime(time_string, "%Y-%m-%d %H:%M:%S")
print("Timestamp:", time.mktime(timestamp))

time.sleep() Module in Python

The time.sleep() function is part of the Python time module, which provides various time-related functionalities. Its primary purpose is to suspend the execution of our program for a specified number of seconds. By calling this function, we can introduce delays to synchronize actions, simulate real-world scenarios, or simply provide breathing space for your program.

The syntax for using time.sleep() is straightforward:

import time


Here, duration represents the number of seconds for which we want our program to pause. It can be an integer or a floating-point number. When time.sleep() is called, the program halts for the specified duration before continuing with the subsequent lines of code.

Let’s explore a few scenarios where time.sleep() can prove to be useful:

  • Creating Animated Effects: Suppose we are developing a game or a graphical application that requires animated effects. By adding controlled delays using time.sleep(), we can create a smooth and visually appealing experience for the user. Pausing for short durations between each frame can give the illusion of movement and fluidity.
import time

for frame in animation_frames:
    time.sleep(0.1)  # Pause for 0.1 seconds between frames
  • Implementing Time-Related Operations: There are cases where we need to execute specific tasks at predefined time intervals. The time.sleep() function allows us to introduce delays between iterations, ensuring that our program runs at the desired pace.
import time

while True:
    time.sleep(60)  # Pause for 60 seconds before the next iteration
  • Controlling Program Flow: Sometimes we may want to pause the execution of our program to wait for user input or create a delay in a specific section of our code. By utilizing time.sleep(), we can introduce a brief delay before proceeding with the subsequent instructions.
import time

time.sleep(2)  # Pause for 2 seconds for dramatic effect

# Other initialization steps
  • Rate Limiting API Requests: When interacting with APIs, it’s often necessary to respect rate limits to avoid overwhelming the server. By using time.sleep(), we can introduce pauses between consecutive API calls, ensuring that we stay within the specified rate limits.
import time
import requests

for request in api_requests:
    response = requests.get(request)
    time.sleep(0.5)  # Pause for 0.5 seconds between API calls

Note: It’s important to note that the duration passed to time.sleep() represents an approximation and can be affected by various factors, such as the system’s scheduling granularity. Thus, the actual pause duration may vary slightly.

In conclusion, the time.sleep() function in Python provides a simple yet powerful tool for introducing delays in our program’s execution.

By leveraging this function, we can control timing, simulate real-world scenarios, and enhance the user experience in our applications. Just remember to use it wisely and consider the specific requirements of our program to achieve optimal results.

Arya Sarkar

Sign up for our Newsletter

Join our newsletter and get tips, tricks and coding tutorials delivered straight to your inbox.