Skip to main content
Version: v4.23

floor

Computes the floor of a number or a time/duration with a specified unit.

floor(x:number)
floor(x:time, unit:duration)
floor(x:duration, unit:duration)

Description

The floor function takes the floor of a number x.

For time and duration values, use the second unit argument to define the rounding unit.

Examples

Take the floor of integers

from {
  x: floor(3.4),
  y: floor(3.5),
  z: floor(-3.4),
}
{
  x: 3,
  y: 3,
  z: -4,
}

Round time and duration values down to a unit

from {
  x: floor(2024-02-24, 1y),
  y: floor(1h52m, 1h)
}
{
  x: 2024-01-01,
  y: 1h,
}

See Also

ceil, round