pandas.Timedelta.round

Timedelta.round(freq)

Round the Timedelta to the specified resolution.

Rounds the Timedelta value to the nearest multiple of the given frequency using half-even rounding.

Parameters:

freqstr

Frequency string indicating the rounding resolution. It uses the same units as class constructor Timedelta.

Returns:

a new Timedelta rounded to the given resolution of freq

Raises:

ValueError if the freq cannot be converted

See also

Timedelta.floor

Floor the Timedelta to the specified resolution.

Timedelta.round

Round the Timedelta to the nearest specified resolution.

Timestamp.ceil

Similar method for Timestamp objects.

Examples

>>> td = pd.Timedelta('1001ms')
>>> td
Timedelta('0 days 00:00:01.001000')
>>> td.round('s')
Timedelta('0 days 00:00:01')