From a62679fab873ff677a8437c2ee78e260b614dd03 Mon Sep 17 00:00:00 2001
From: Mattias Jonsson <mjonss@users.noreply.github.com>
Date: Wed, 16 Oct 2024 10:28:43 +0200
Subject: [PATCH] Added EXTRACT(<time unit> FROM <date/datetime/time col) as
 partition pruning function (#18456)

---
 partition-pruning.md | 1 +
 partitioned-table.md | 1 +
 2 files changed, 2 insertions(+)

diff --git a/partition-pruning.md b/partition-pruning.md
index d047fd9a90eea..31b122f620fee 100644
--- a/partition-pruning.md
+++ b/partition-pruning.md
@@ -240,6 +240,7 @@ If the `fn` function is monotonous, for any `x` and `y`, if `x > y`, then `fn(x)
 
 * [`UNIX_TIMESTAMP()`](/functions-and-operators/date-and-time-functions.md)
 * [`TO_DAYS()`](/functions-and-operators/date-and-time-functions.md)
+* [`EXTRACT(<time unit> FROM <DATETIME/DATE/TIME column>)`](/functions-and-operators/date-and-time-functions.md). For `DATE` and `DATETIME` columns, `YEAR` and `YEAR_MONTH` time units are considered monotonous functions. For the `TIME` column, `HOUR`, `HOUR_MINUTE`, `HOUR_SECOND` and `HOUR_MICROSECOND` are considered monotonous functions. Note that `WEEK` is not supported as time unit in `EXTRACT` for partition pruning.
 
 For example, partition pruning takes effect when the partition expression is in the form of `fn(col)`, where the `fn` is monotonous function `to_days`:
 
diff --git a/partitioned-table.md b/partitioned-table.md
index 9fea6fec90421..000345ac13161 100644
--- a/partitioned-table.md
+++ b/partitioned-table.md
@@ -1305,6 +1305,7 @@ Currently, partition pruning does not work with `LIKE` conditions.
 
     * [`UNIX_TIMESTAMP()`](/functions-and-operators/date-and-time-functions.md)
     * [`TO_DAYS()`](/functions-and-operators/date-and-time-functions.md)
+    * [`EXTRACT(<time unit> FROM <DATETIME/DATE/TIME column>)`](/functions-and-operators/date-and-time-functions.md). For `DATE` and `DATETIME` columns, `YEAR` and `YEAR_MONTH` time units are considered monotonous functions. For the `TIME` column, `HOUR`, `HOUR_MINUTE`, `HOUR_SECOND` and `HOUR_MICROSECOND` are considered monotonous functions. Note that `WEEK` is not supported as time unit in `EXTRACT` for partition pruning.
 
     For example, the partition expression is a simple column: