Python Pandas - Round the Timedelta with minutely frequency

To round the Timedelta with specified resolution, use the timestamp.round() method. Set the minutely frequency resolution using the freq parameter with value 'T'.

What is Timedelta Rounding?

Timedelta rounding allows you to reduce the precision of time differences by rounding to the nearest specified unit. When rounding with minutely frequency, seconds and smaller units are rounded to the nearest minute.

Syntax

timedelta.round(freq='T')

Parameters:

• freq − The frequency string for rounding. Use 'T' for minutely frequency

Creating a Timedelta Object

First, import the required library and create a Timedelta object ?

import pandas as pd

# Create a Timedelta object with various time components
timedelta = pd.Timedelta('2 days 10 hours 45 min 20 s 35 ms 55 ns')

# Display the original Timedelta
print("Original Timedelta:")
print(timedelta)

Original Timedelta:
2 days 10:45:20.035000055

Rounding with Minutely Frequency

Now round the Timedelta to the nearest minute using freq='T' ?

import pandas as pd

# Create a Timedelta object
timedelta = pd.Timedelta('2 days 10 hours 45 min 20 s 35 ms 55 ns')

# Round to minutely frequency
rounded_timedelta = timedelta.round(freq='T')

print("Original Timedelta:")
print(timedelta)
print("\nRounded Timedelta (minutely):")
print(rounded_timedelta)

Original Timedelta:
2 days 10:45:20.035000055

Rounded Timedelta (minutely):
2 days 10:45:00

Multiple Examples

Here are examples showing how different time values round to the nearest minute ?

import pandas as pd

# Different Timedelta examples
examples = [
    pd.Timedelta('1 hour 30 min 25 s'),
    pd.Timedelta('45 min 30 s'),
    pd.Timedelta('2 min 45 s'),
    pd.Timedelta('1 min 29 s')
]

for td in examples:
    rounded = td.round(freq='T')
    print(f"Original: {td} ? Rounded: {rounded}")

Original: 0 days 01:30:25 ? Rounded: 0 days 01:30:00
Original: 0 days 00:45:30 ? Rounded: 0 days 00:46:00
Original: 0 days 00:02:45 ? Rounded: 0 days 00:03:00
Original: 0 days 00:01:29 ? Rounded: 0 days 00:01:00

How Rounding Works

When rounding to minutely frequency:

• Seconds ? 30 round up to the next minute
• Seconds < 30 round down to the current minute
• Milliseconds, microseconds, and nanoseconds are ignored

Conclusion

Use timedelta.round(freq='T') to round Timedelta objects to the nearest minute. This is useful for simplifying time calculations and reducing precision when exact seconds aren't needed.