Skip to main content
`Ctrl`+`K`

# pandas.Timedelta.floor

Timedelta.floor(freq)

  Return a new Timedelta floored to this resolution.

  Truncates the Timedelta to the nearest multiple of the given frequency, rounding toward negative infinity.

  Parameters:
    freq str or timedelta

      Frequency string or timedelta value indicating the flooring resolution. It uses the same units as class constructor `Timedelta`.

  Returns:
    Timedelta

      A new Timedelta object floored to the specified resolution.

  See also

  `Timedelta.ceil`

    Ceil the Timedelta to the specified resolution.

  `Timedelta.round`

    Round the Timedelta to the specified resolution.

  `Timestamp.floor`

    Similar method for Timestamp objects.

  Examples

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

  `freq` can also be a timedelta value:

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