2018-05-07 03:32:16 +02:00
|
|
|
---
|
|
|
|
layout: "functions"
|
2018-12-20 05:35:11 +01:00
|
|
|
page_title: "floor - Functions - Configuration Language"
|
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
|
|
|
|
|
2019-01-17 01:33:57 +01:00
|
|
|
-> **Note:** This page is about Terraform 0.12 and later. For Terraform 0.11 and
|
|
|
|
earlier, see
|
|
|
|
[0.11 Configuration Language: Interpolation Syntax](../../configuration-0-11/interpolation.html).
|
|
|
|
|
2018-05-07 03:32:16 +02:00
|
|
|
`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.
|