mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-28 17:34:17 -04:00
1541da5e65
This modifies the ESQL test infrastructure to generate more of the documentation for functions. It generates the *Description* section, the *Examples* section, and the *Parameters* section as separate files so we can use them as needed. It also generates a `layout` file that's just a guess as to how to render the whole thing. In some cases it'll work and we can use that instead of hand maintaining a "top level" description file for the function. Most newly generated files are unused. We have to chose to pick them up by replacing the sections we were manually maintaining with an include of the generated section. Or by replacing the entire hand maintained file with the generated top level file. Relates to #104247
34 lines
783 B
Text
34 lines
783 B
Text
[discrete]
|
|
[[esql-round]]
|
|
=== `ROUND`
|
|
*Syntax*
|
|
|
|
[.text-center]
|
|
image::esql/functions/signature/round.svg[Embedded,opts=inline]
|
|
|
|
*Parameters*
|
|
|
|
`value`::
|
|
Numeric expression. If `null`, the function returns `null`.
|
|
|
|
`decimals`::
|
|
Numeric expression. If `null`, the function returns `null`.
|
|
|
|
*Description*
|
|
|
|
Rounds a number to the closest number with the specified number of digits.
|
|
Defaults to 0 digits if no number of digits is provided. If the specified number
|
|
of digits is negative, rounds to the number of digits left of the decimal point.
|
|
|
|
include::types/round.asciidoc[]
|
|
|
|
*Example*
|
|
|
|
[source.merge.styled,esql]
|
|
----
|
|
include::{esql-specs}/docs.csv-spec[tag=round]
|
|
----
|
|
[%header.monospaced.styled,format=dsv,separator=|]
|
|
|===
|
|
include::{esql-specs}/docs.csv-spec[tag=round-result]
|
|
|===
|