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

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