Skip to main content
`Ctrl`+`K`

# 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:
    freq str or timedelta

      Frequency string or timedelta value 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.ceil`

    Ceil the Timedelta to the specified resolution.

  `Timestamp.round`

    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')

  `freq` can also be a timedelta value:

      >>> td.round(freq=pd.Timedelta('1s'))
      Timedelta('0 days 00:00:01')