elasticsearch/docs/reference/esql/functions/floor.asciidoc

[discrete]
[[esql-floor]]
=== `FLOOR`

*Syntax*

[.text-center]
image::esql/functions/signature/floor.svg[Embedded,opts=inline]

*Parameters*

`n`::
Numeric expression. If `null`, the function returns `null`.

*Description*

Rounds a number down to the nearest integer.

NOTE: This is a noop for `long` (including unsigned) and `integer`.
      For `double` this picks the closest `double` value to the integer
      similar to {javadoc}/java.base/java/lang/Math.html#floor(double)[Math.floor].

include::types/floor.asciidoc[]

*Example*

[source.merge.styled,esql]
----
include::{esql-specs}/math.csv-spec[tag=floor]
----
[%header.monospaced.styled,format=dsv,separator=|]
|===
include::{esql-specs}/math.csv-spec[tag=floor-result]
|===