terraform/website/docs/language/functions/floor.html.md

---
layout: "language"
page_title: "floor - Functions - Configuration Language"
sidebar_current: "docs-funcs-numeric-floor"
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

```
> floor(5)
5
> floor(4.9)
4
```

## Related Functions

* [`ceil`](./ceil.html), which rounds to the nearest whole number _greater than_
  or equal.
website: Beginnings of "Functions" configuration section Previously we just listed out all of the functions in alphabetical order inside the "Interpolation Syntax" page, but that format doesn't leave much room for details and usage examples. Now we give each function its own page, and categorize them for easier navigation. While many functions are very simple and don't really warrant a full page, certain functions do have additional details that are worth mentioning and this structure scales better for those more complicated functions. So far this includes only the numeric and string functions. Other categories will follow in subsequent commits. 2018-05-07 03:32:16 +02:00			`---`
website: Adopt a ton of pages into the "language" layout As of this commit, that layout doesn't exist yet, but I'm isolating the one-line changes to their own commit to try and keep your eyes from glazing over. 2020-08-15 03:51:06 +02:00			`layout: "language"`
website: Update functions section page titles 2018-12-20 05:35:11 +01:00			`page_title: "floor - Functions - Configuration Language"`
website: Beginnings of "Functions" configuration section Previously we just listed out all of the functions in alphabetical order inside the "Interpolation Syntax" page, but that format doesn't leave much room for details and usage examples. Now we give each function its own page, and categorize them for easier navigation. While many functions are very simple and don't really warrant a full page, certain functions do have additional details that are worth mentioning and this structure scales better for those more complicated functions. So far this includes only the numeric and string functions. Other categories will follow in subsequent commits. 2018-05-07 03:32:16 +02:00			`sidebar_current: "docs-funcs-numeric-floor"`
			`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`

			```
			`> floor(5)`
			`5`
			`> floor(4.9)`
			`4`
			```

			`## Related Functions`

			* [`ceil`](./ceil.html), which rounds to the nearest whole number _greater than_
			`or equal.`