elastic · leontyevdv · Aug 27, 2025 · Jul 17, 2025 · Jul 22, 2025 · Jul 22, 2025
diff --git a/docs/reference/query-languages/esql/_snippets/functions/description/md5.md b/docs/reference/query-languages/esql/_snippets/functions/description/md5.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/description/tbucket.md b/docs/reference/query-languages/esql/_snippets/functions/description/tbucket.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/examples/knn.md b/docs/reference/query-languages/esql/_snippets/functions/examples/knn.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/examples/tbucket.md b/docs/reference/query-languages/esql/_snippets/functions/examples/tbucket.md
diff --git a/...ence/query-languages/esql/_snippets/functions/functionNamedParams/categorize.md b/...ence/query-languages/esql/_snippets/functions/functionNamedParams/categorize.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/functionNamedParams/knn.md b/docs/reference/query-languages/esql/_snippets/functions/functionNamedParams/knn.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/layout/tbucket.md b/docs/reference/query-languages/esql/_snippets/functions/layout/tbucket.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/parameters/knn.md b/docs/reference/query-languages/esql/_snippets/functions/parameters/knn.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/parameters/tbucket.md b/docs/reference/query-languages/esql/_snippets/functions/parameters/tbucket.md
diff --git a/docs/reference/query-languages/esql/_snippets/functions/types/tbucket.md b/docs/reference/query-languages/esql/_snippets/functions/types/tbucket.md
diff --git a/docs/reference/query-languages/esql/functions-operators/grouping-functions.md b/docs/reference/query-languages/esql/functions-operators/grouping-functions.md
@@ -16,7 +16,10 @@ The [`STATS`](/reference/query-languages/esql/commands/processing-commands.md#es
 :::{include} ../_snippets/functions/layout/bucket.md
 :::
 
-:::{note} 
+:::{include} ../_snippets/functions/layout/tbucket.md
+:::
+
+:::{note}
 The `CATEGORIZE` function requires a [platinum license](https://www.elastic.co/subscriptions).
 :::
 

diff --git a/docs/reference/query-languages/esql/images/functions/tbucket.svg b/docs/reference/query-languages/esql/images/functions/tbucket.svg
diff --git a/docs/reference/query-languages/esql/kibana/definition/commands/rrf.json b/docs/reference/query-languages/esql/kibana/definition/commands/rrf.json
diff --git a/docs/reference/query-languages/esql/kibana/definition/functions/md5.json b/docs/reference/query-languages/esql/kibana/definition/functions/md5.json
diff --git a/docs/reference/query-languages/esql/kibana/definition/functions/tbucket.json b/docs/reference/query-languages/esql/kibana/definition/functions/tbucket.json
diff --git a/docs/reference/query-languages/esql/kibana/docs/functions/md5.md b/docs/reference/query-languages/esql/kibana/docs/functions/md5.md
diff --git a/docs/reference/query-languages/esql/kibana/docs/functions/tbucket.md b/docs/reference/query-languages/esql/kibana/docs/functions/tbucket.md
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/tbucket.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/tbucket.csv-spec
@@ -0,0 +1,18 @@
+// TBUCKET-specific tests
+
+docsTBucketByTimeDuration#[skip:-9.1.99,reason:new grouping function added in 9.2]
+required_capability: implicit_casting_string_literal_to_temporal_amount
+
+// tag::docsTBucketByTimeDuration[]
+FROM sample_data
+| STATS min = MAX(@timestamp), max = MAX(@timestamp) BY bucket = TBUCKET(30 minutes)
+| SORT min
+// end::docsTBucketByTimeDuration[]
+;
+
+// tag::docsTBucketByTimeDuration-result[]
+          min:date      |          max:date      |         bucket:date
+2023-10-23T12:27:28.948Z|2023-10-23T12:27:28.948Z|2023-10-23T12:00:00.000Z
+2023-10-23T13:55:01.543Z|2023-10-23T13:55:01.543Z|2023-10-23T13:30:00.000Z
+// end::docsTBucketByTimeDuration-result[]
+;
diff --git a/.../src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java b/.../src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
@@ -53,6 +53,7 @@
 import org.elasticsearch.xpack.esql.expression.function.fulltext.Term;
 import org.elasticsearch.xpack.esql.expression.function.grouping.Bucket;
 import org.elasticsearch.xpack.esql.expression.function.grouping.Categorize;
+import org.elasticsearch.xpack.esql.expression.function.grouping.TBucket;
 import org.elasticsearch.xpack.esql.expression.function.scalar.conditional.Case;
 import org.elasticsearch.xpack.esql.expression.function.scalar.conditional.Greatest;
 import org.elasticsearch.xpack.esql.expression.function.scalar.conditional.Least;
@@ -305,7 +306,8 @@ private static FunctionDefinition[][] functions() {
             // grouping functions
             new FunctionDefinition[] {
                 def(Bucket.class, Bucket::new, "bucket", "bin"),
-                def(Categorize.class, Categorize::new, "categorize") },
+                def(Categorize.class, Categorize::new, "categorize"),
+                def(TBucket.class, uni(TBucket::new), "tbucket") },
             // aggregate functions
             // since they declare two public constructors - one with filter (for nested where) and one without
             // use casting to disambiguate between the two

diff --git a/...ain/java/org/elasticsearch/xpack/esql/expression/function/grouping/GroupingWritables.java b/...ain/java/org/elasticsearch/xpack/esql/expression/function/grouping/GroupingWritables.java
@@ -14,6 +14,6 @@
 public class GroupingWritables {
 
     public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
-        return List.of(Bucket.ENTRY, Categorize.ENTRY);
+        return List.of(Bucket.ENTRY, Categorize.ENTRY, TBucket.ENTRY);
     }
 }