---
layout: docs
page_title: floor - Functions - Configuration Language
description: |-
  The floor function returns the closest whole number less than or equal to
  the given value.
---

# `floor` Function

`floor` returns the closest whole number that is less than or equal to the
given value, which may be a fraction.

## Examples

```shell-session
> floor(5)
5
> floor(4.9)
4
```

## Related Functions

- [`ceil`](/docs/job-specification/hcl2/functions/numeric/ceil), which rounds to the nearest whole number _greater than_
  or equal.
