From ea08218b66ac95db336b7c71af32d7dcb42c0c41 Mon Sep 17 00:00:00 2001 From: Nik Everett Date: Fri, 23 May 2025 10:16:11 -0400 Subject: [PATCH 1/4] ESQL: Enable docs for ROUND_TO Plug the docs in for ROUND_TO. --- .../query-languages/esql/functions-operators/math-functions.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/reference/query-languages/esql/functions-operators/math-functions.md b/docs/reference/query-languages/esql/functions-operators/math-functions.md index 08d7da548d4aa..454a72f463d61 100644 --- a/docs/reference/query-languages/esql/functions-operators/math-functions.md +++ b/docs/reference/query-languages/esql/functions-operators/math-functions.md @@ -63,6 +63,9 @@ mapped_pages: :::{include} ../_snippets/functions/layout/pow.md ::: +:::{include} ../_snippets/functions/layout/round_to.md +::: + :::{include} ../_snippets/functions/layout/round.md ::: From abc72c6fdd1de8db202eaa06dd2068c11bb1d111 Mon Sep 17 00:00:00 2001 From: Nik Everett Date: Fri, 23 May 2025 11:43:35 -0400 Subject: [PATCH 2/4] Update docs --- .../esql/_snippets/functions/layout/round_to.md | 4 ++++ .../esql/_snippets/lists/math-functions.md | 1 + .../esql/functions-operators/math-functions.md | 4 ++-- .../expression/function/scalar/math/RoundTo.java | 16 ++++++++++++++-- 4 files changed, 21 insertions(+), 4 deletions(-) diff --git a/docs/reference/query-languages/esql/_snippets/functions/layout/round_to.md b/docs/reference/query-languages/esql/_snippets/functions/layout/round_to.md index 3e8fed6a784ad..1f509a2e2c897 100644 --- a/docs/reference/query-languages/esql/_snippets/functions/layout/round_to.md +++ b/docs/reference/query-languages/esql/_snippets/functions/layout/round_to.md @@ -1,6 +1,10 @@ % This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it. ## `ROUND_TO` [esql-round_to] +```{applies_to} +product: COMING 8.19.0/9.1.0 +serverless: GA +``` **Syntax** diff --git a/docs/reference/query-languages/esql/_snippets/lists/math-functions.md b/docs/reference/query-languages/esql/_snippets/lists/math-functions.md index 5c858d3a7147a..5d3a419f69830 100644 --- a/docs/reference/query-languages/esql/_snippets/lists/math-functions.md +++ b/docs/reference/query-languages/esql/_snippets/lists/math-functions.md @@ -16,6 +16,7 @@ * [`PI`](../../functions-operators/math-functions.md#esql-pi) * [`POW`](../../functions-operators/math-functions.md#esql-pow) * [`ROUND`](../../functions-operators/math-functions.md#esql-round) +* [`ROUND_TO`](../../functions-operators/math-functions.md#esql-round-to) * [`SCALB`](../../functions-operators/math-functions.md#esql-scalb) * [`SIGNUM`](../../functions-operators/math-functions.md#esql-signum) * [`SIN`](../../functions-operators/math-functions.md#esql-sin) diff --git a/docs/reference/query-languages/esql/functions-operators/math-functions.md b/docs/reference/query-languages/esql/functions-operators/math-functions.md index 454a72f463d61..2a4cb855717d7 100644 --- a/docs/reference/query-languages/esql/functions-operators/math-functions.md +++ b/docs/reference/query-languages/esql/functions-operators/math-functions.md @@ -63,10 +63,10 @@ mapped_pages: :::{include} ../_snippets/functions/layout/pow.md ::: -:::{include} ../_snippets/functions/layout/round_to.md +:::{include} ../_snippets/functions/layout/round.md ::: -:::{include} ../_snippets/functions/layout/round.md +:::{include} ../_snippets/functions/layout/round_to.md ::: :::{include} ../_snippets/functions/layout/scalb.md diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/math/RoundTo.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/math/RoundTo.java index 38a6e2af5c672..5b5f1e0455dce 100644 --- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/math/RoundTo.java +++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/math/RoundTo.java @@ -20,6 +20,8 @@ import org.elasticsearch.xpack.esql.core.tree.Source; import org.elasticsearch.xpack.esql.core.type.DataType; import org.elasticsearch.xpack.esql.expression.function.Example; +import org.elasticsearch.xpack.esql.expression.function.FunctionAppliesTo; +import org.elasticsearch.xpack.esql.expression.function.FunctionAppliesToLifecycle; import org.elasticsearch.xpack.esql.expression.function.FunctionInfo; import org.elasticsearch.xpack.esql.expression.function.Param; import org.elasticsearch.xpack.esql.expression.function.scalar.EsqlScalarFunction; @@ -50,8 +52,18 @@ public class RoundTo extends EsqlScalarFunction { private DataType resultType; - @FunctionInfo(returnType = { "double", "integer", "long", "date", "date_nanos" }, description = """ - Rounds down to one of a list of fixed points.""", examples = @Example(file = "math", tag = "round_to")) + @FunctionInfo( + returnType = { "double", "integer", "long", "date", "date_nanos" }, + description = """ + Rounds down to one of a list of fixed points.""", + examples = @Example(file = "math", tag = "round_to"), + appliesTo = { + @FunctionAppliesTo( + lifeCycle = FunctionAppliesToLifecycle.COMING, + version = "8.19.0/9.1.0" + ) + } + ) public RoundTo( Source source, @Param( From ebca79fdad030c9f5a5e4136478256a7fed80bc6 Mon Sep 17 00:00:00 2001 From: Nik Everett Date: Fri, 23 May 2025 11:48:41 -0400 Subject: [PATCH 3/4] Fix --- .../query-languages/esql/_snippets/lists/math-functions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/_snippets/lists/math-functions.md b/docs/reference/query-languages/esql/_snippets/lists/math-functions.md index 5d3a419f69830..54c1a4dd9635a 100644 --- a/docs/reference/query-languages/esql/_snippets/lists/math-functions.md +++ b/docs/reference/query-languages/esql/_snippets/lists/math-functions.md @@ -16,7 +16,7 @@ * [`PI`](../../functions-operators/math-functions.md#esql-pi) * [`POW`](../../functions-operators/math-functions.md#esql-pow) * [`ROUND`](../../functions-operators/math-functions.md#esql-round) -* [`ROUND_TO`](../../functions-operators/math-functions.md#esql-round-to) +* [`ROUND_TO`](../../functions-operators/math-functions.md#esql-round_to) * [`SCALB`](../../functions-operators/math-functions.md#esql-scalb) * [`SIGNUM`](../../functions-operators/math-functions.md#esql-signum) * [`SIN`](../../functions-operators/math-functions.md#esql-sin) From 8ff8c18a043fc6d1656b830e4f2219c91265ed03 Mon Sep 17 00:00:00 2001 From: elasticsearchmachine Date: Fri, 23 May 2025 15:56:48 +0000 Subject: [PATCH 4/4] [CI] Auto commit changes from spotless --- .../esql/expression/function/scalar/math/RoundTo.java | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/math/RoundTo.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/math/RoundTo.java index 5b5f1e0455dce..adf8ab7ce0401 100644 --- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/math/RoundTo.java +++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/math/RoundTo.java @@ -57,12 +57,7 @@ public class RoundTo extends EsqlScalarFunction { description = """ Rounds down to one of a list of fixed points.""", examples = @Example(file = "math", tag = "round_to"), - appliesTo = { - @FunctionAppliesTo( - lifeCycle = FunctionAppliesToLifecycle.COMING, - version = "8.19.0/9.1.0" - ) - } + appliesTo = { @FunctionAppliesTo(lifeCycle = FunctionAppliesToLifecycle.COMING, version = "8.19.0/9.1.0") } ) public RoundTo( Source source,