From fb526d1d53e7c7ba890a6ecf934afb6f8cf34760 Mon Sep 17 00:00:00 2001
From: linzhenqi <linzhenqi@selectdb.com>
Date: Sun, 4 Jan 2026 14:35:08 +0800
Subject: [PATCH 1/3] ADD/SUB_TIME

---
 .../date-time-functions/add-time.md                | 13 +++++++++++--
 .../date-time-functions/sub-time.md                | 13 +++++++++++--
 .../date-time-functions/add-time.md                | 14 +++++++++++---
 .../date-time-functions/sub-time.md                | 13 +++++++++++--
 .../date-time-functions/add-time.md                | 13 +++++++++++--
 .../date-time-functions/sub-time.md                | 13 +++++++++++--
 .../date-time-functions/add-time.md                | 13 +++++++++++--
 .../date-time-functions/sub-time.md                | 13 +++++++++++--
 8 files changed, 88 insertions(+), 17 deletions(-)

diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
index 3aa53050cd21f..d789545ced88f 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
@@ -20,19 +20,20 @@ ADD_TIME(`<date_or_time_expr>`, `<time>`)
 
 | Parameter             | Description |
 | ---------------------| ----------- |
-| `<date_or_time_expr>`| A valid date expression. Supports input of datetime/date/time types. If the type is date, it will be converted to the start time of the day (00:00:00). For specific datetime/time formats, see [datetime conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [time conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/time-conversion). |
+| `<date_or_time_expr>`| A valid date expression. Supports input of timestamptz/datetime/date/time types. If the type is date, it will be converted to the start time of the day (00:00:00). For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [time conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/time-conversion). |
 | `<time>`             | A valid time expression, representing the time value to be added to `<date_or_time_expr>`. If negative, it means subtraction. Supports input of time type. |
 
 ## Return Value
 
 Returns the result of adding `<time>` to `<date_or_time_expr>`. The return type depends on the type of the first parameter:
+- If the first parameter is of timestamptz type, returns timestamptz type.
 - If the first parameter is of datetime type, returns datetime type.
 - If the first parameter is of time type, returns time type.
 
 Special cases:
 - If any input parameter is null, returns null.
 - If the first parameter is of time type and the result exceeds the time type range, returns the maximum (or minimum) time value.
-- If the first parameter is of datetime type and the result exceeds the datetime type range, an error is thrown.
+- If the first parameter is of datetime or timestamptz type and the result exceeds the datetime type range, an error is thrown.
 
 ## Examples
 
@@ -52,6 +53,14 @@ SELECT ADD_TIME(cast('12:15:20' as time), '00:10:40');
 +------------------------------------------------+
 | 12:26:00                                       |
 +------------------------------------------------+   
+
+-- SET time_zone = '+08:00';
+SELECT ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03');
++-----------------------------------------------------------+
+| ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03') |
++-----------------------------------------------------------+
+| 2025-10-10 17:24:36.123457+08:00                          |
++-----------------------------------------------------------+
          
 -- NULL parameter test
 SELECT ADD_TIME(NULL, '01:00:00');
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
index 41c08751926bd..8ef445d557b50 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
@@ -20,19 +20,20 @@ SUB_TIME(`<date_or_time_expr>`, `<time>`)
 
 | Parameter             | Description |
 | ---------------------| ----------- |
-| `<date_or_time_expr>`| A valid date expression. Supports input of datetime/date/time types. If the type is date, it will be converted to the start time of the day (00:00:00). For specific datetime/time formats, see [datetime conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [time conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/time-conversion). |
+| `<date_or_time_expr>`| A valid date expression. Supports input of timestamptz/datetime/date/time types. If the type is date, it will be converted to the start time of the day (00:00:00). For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [time conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/time-conversion). |
 | `<time>`             | A valid time expression, representing the time value to be subtracted from `<date_or_time_expr>`. If negative, it means addition. Supports input of time type. |
 
 ## Return Value
 
 Returns the result of subtracting `<time>` from `<date_or_time_expr>`. The return type depends on the type of the first parameter:
+- If the first parameter is of timestamp type, returns timestamp type.
 - If the first parameter is of datetime type, returns datetime type.
 - If the first parameter is of time type, returns time type.
 
 Special cases:
 - If any input parameter is null, returns null.
 - If the first parameter is of time type and the result exceeds the time type range, returns the maximum (or minimum) time value.
-- If the first parameter is of datetime type and the result exceeds the datetime type range, an error is thrown.
+- If the first parameter is of datetime or timestamptz type and the result exceeds the datetime type range, an error is thrown.
 
 ## Examples
 
@@ -52,6 +53,14 @@ SELECT SUB_TIME(cast('12:15:20' as time), '00:10:40');
 +------------------------------------------------+
 | 12:04:40                                       |
 +------------------------------------------------+   
+
+-- SET time_zone = '+08:00'
+select sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123');
++------------------------------------------------------+
+| sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123') |
++------------------------------------------------------+
+| 2025-10-10 12:59:59.877+08:00                        |
++------------------------------------------------------+
          
 -- NULL parameter test
 SELECT SUB_TIME(NULL, '01:00:00');
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
index a2f419337b56f..5b7804489ddf4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
@@ -21,20 +21,20 @@ ADD_TIME(`<date_or_time_expr>`, `<time>`)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 datetime/date/time 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体 datetime//time 格式请查看  [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [time的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 timestamptz/datetime/date/time 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [time的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
 |  `<time>`        |  参数为合法的时间表达式，表示增加到`<date_or_time_expr>` 上面的时间值，若为负数，则表示减少，支持输入 time 类型  |
 
 ## 返回值
 
 返回 `<date_or_time_expr>` 添加 `<time>` 时间值之后的结果，根据第一个参数类型返回不同的类型
+- 若第一个参数为 timestamptz 类型，则返回 timestamptz 类型
 - 若第一个参数为 datetime 类型，则返回 datetime 类型
 - 若第一个参数为 time 类型，则返回 time 类型
 
 特殊情况:
 - 若输入参数包含 null ,返回 null
 - 若第一个参数类型为 time 类型，且计算结果超出 time 类型范围，则返回 time 类型最大（最小值）
-- 若第一个参数类型为 datetime 类型，且计算结果超出 datetime 类型，则跑出错误
-
+- 若第一个参数类型为 datetime 或 timestamptz 类型，且计算结果超出 datetime 类型的范围，则抛出错误
 
 ## 举例
 
@@ -54,6 +54,14 @@ SELECT ADD_TIME(cast('12:15:20' as time), '00:10:40');
 +------------------------------------------------+
 | 12:26:00                                       |
 +------------------------------------------------+   
+
+-- SET time_zone = '+08:00';
+SELECT ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03');
++-----------------------------------------------------------+
+| ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03') |
++-----------------------------------------------------------+
+| 2025-10-10 17:24:36.123457+08:00                          |
++-----------------------------------------------------------+
          
 -- NULL 参数测试
 SELECT ADD_TIME(NULL, '01:00:00');
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
index 8cd1b4d60de94..296fd0572f075 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
@@ -20,19 +20,20 @@ SUB_TIME(`<date_or_time_expr>`, `<time>`)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 datetime/date/time 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体 datetime//time 格式请查看  [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [time的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 timestamptz/datetime/date/time 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [time的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
 |  `<time>`        |  参数为合法的时间表达式，表示从`<date_or_time_expr>` 中减去的时间值，若为负数，则表示增加，支持输入 time 类型  |
 
 ## 返回值
 
 返回 `<date_or_time_expr>` 减去 `<time>` 时间值之后的结果，根据第一个参数类型返回不同的类型
+- 若第一个参数为 timestamptz 类型，则返回 timestamptz 类型
 - 若第一个参数为 datetime 类型，则返回 datetime 类型
 - 若第一个参数为 time 类型，则返回 time 类型
 
 特殊情况:
 - 若输入参数包含 null ,返回 null
 - 若第一个参数类型为 time 类型，且计算结果超出 time 类型范围，则返回 time 类型最大（最小值）
-- 若第一个参数类型为 datetime 类型，且计算结果超出 datetime 类型，则跑出错误
+- 若第一个参数类型为 datetime 或 timestamptz 类型，且计算结果超出 datetime 类型范围，则抛出错误
 
 ## 举例
 
@@ -52,6 +53,14 @@ SELECT SUB_TIME(cast('12:15:20' as time), '00:10:40');
 +------------------------------------------------+
 | 12:04:40                                       |
 +------------------------------------------------+   
+
+-- SET time_zone = '+08:00'
+select sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123');
++------------------------------------------------------+
+| sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123') |
++------------------------------------------------------+
+| 2025-10-10 12:59:59.877+08:00                        |
++------------------------------------------------------+
          
 -- NULL 参数测试
 SELECT SUB_TIME(NULL, '01:00:00');
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
index a2f419337b56f..241542604819d 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
@@ -21,19 +21,20 @@ ADD_TIME(`<date_or_time_expr>`, `<time>`)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 datetime/date/time 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体 datetime//time 格式请查看  [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [time的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 timestamptz/datetime/date/time 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [time的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
 |  `<time>`        |  参数为合法的时间表达式，表示增加到`<date_or_time_expr>` 上面的时间值，若为负数，则表示减少，支持输入 time 类型  |
 
 ## 返回值
 
 返回 `<date_or_time_expr>` 添加 `<time>` 时间值之后的结果，根据第一个参数类型返回不同的类型
+- 若第一个参数为 timestamptz 类型，则返回 timestamptz 类型
 - 若第一个参数为 datetime 类型，则返回 datetime 类型
 - 若第一个参数为 time 类型，则返回 time 类型
 
 特殊情况:
 - 若输入参数包含 null ,返回 null
 - 若第一个参数类型为 time 类型，且计算结果超出 time 类型范围，则返回 time 类型最大（最小值）
-- 若第一个参数类型为 datetime 类型，且计算结果超出 datetime 类型，则跑出错误
+- 若第一个参数类型为 datetime 或 timestamptz 类型，且计算结果超出 datetime 类型的范围，则抛出错误
 
 
 ## 举例
@@ -54,6 +55,14 @@ SELECT ADD_TIME(cast('12:15:20' as time), '00:10:40');
 +------------------------------------------------+
 | 12:26:00                                       |
 +------------------------------------------------+   
+
+-- SET time_zone = '+08:00';
+SELECT ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03');
++-----------------------------------------------------------+
+| ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03') |
++-----------------------------------------------------------+
+| 2025-10-10 17:24:36.123457+08:00                          |
++-----------------------------------------------------------+
          
 -- NULL 参数测试
 SELECT ADD_TIME(NULL, '01:00:00');
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
index 8cd1b4d60de94..fe3970a58e112 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
@@ -20,19 +20,20 @@ SUB_TIME(`<date_or_time_expr>`, `<time>`)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 datetime/date/time 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体 datetime//time 格式请查看  [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [time的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 timestamptz/datetime/date/time 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体格式请查看  [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [time的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
 |  `<time>`        |  参数为合法的时间表达式，表示从`<date_or_time_expr>` 中减去的时间值，若为负数，则表示增加，支持输入 time 类型  |
 
 ## 返回值
 
 返回 `<date_or_time_expr>` 减去 `<time>` 时间值之后的结果，根据第一个参数类型返回不同的类型
+- 若第一个参数为 timestamptz 类型，则返回 timestamptz 类型
 - 若第一个参数为 datetime 类型，则返回 datetime 类型
 - 若第一个参数为 time 类型，则返回 time 类型
 
 特殊情况:
 - 若输入参数包含 null ,返回 null
 - 若第一个参数类型为 time 类型，且计算结果超出 time 类型范围，则返回 time 类型最大（最小值）
-- 若第一个参数类型为 datetime 类型，且计算结果超出 datetime 类型，则跑出错误
+- 若第一个参数类型为 datetime 或 timestmaptz 类型，且计算结果超出 datetime 类型的范围，则抛出错误
 
 ## 举例
 
@@ -52,6 +53,14 @@ SELECT SUB_TIME(cast('12:15:20' as time), '00:10:40');
 +------------------------------------------------+
 | 12:04:40                                       |
 +------------------------------------------------+   
+
+-- SET time_zone = '+08:00'
+select sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123');
++------------------------------------------------------+
+| sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123') |
++------------------------------------------------------+
+| 2025-10-10 12:59:59.877+08:00                        |
++------------------------------------------------------+
          
 -- NULL 参数测试
 SELECT SUB_TIME(NULL, '01:00:00');
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
index 3aa53050cd21f..d789545ced88f 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/add-time.md
@@ -20,19 +20,20 @@ ADD_TIME(`<date_or_time_expr>`, `<time>`)
 
 | Parameter             | Description |
 | ---------------------| ----------- |
-| `<date_or_time_expr>`| A valid date expression. Supports input of datetime/date/time types. If the type is date, it will be converted to the start time of the day (00:00:00). For specific datetime/time formats, see [datetime conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [time conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/time-conversion). |
+| `<date_or_time_expr>`| A valid date expression. Supports input of timestamptz/datetime/date/time types. If the type is date, it will be converted to the start time of the day (00:00:00). For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [time conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/time-conversion). |
 | `<time>`             | A valid time expression, representing the time value to be added to `<date_or_time_expr>`. If negative, it means subtraction. Supports input of time type. |
 
 ## Return Value
 
 Returns the result of adding `<time>` to `<date_or_time_expr>`. The return type depends on the type of the first parameter:
+- If the first parameter is of timestamptz type, returns timestamptz type.
 - If the first parameter is of datetime type, returns datetime type.
 - If the first parameter is of time type, returns time type.
 
 Special cases:
 - If any input parameter is null, returns null.
 - If the first parameter is of time type and the result exceeds the time type range, returns the maximum (or minimum) time value.
-- If the first parameter is of datetime type and the result exceeds the datetime type range, an error is thrown.
+- If the first parameter is of datetime or timestamptz type and the result exceeds the datetime type range, an error is thrown.
 
 ## Examples
 
@@ -52,6 +53,14 @@ SELECT ADD_TIME(cast('12:15:20' as time), '00:10:40');
 +------------------------------------------------+
 | 12:26:00                                       |
 +------------------------------------------------+   
+
+-- SET time_zone = '+08:00';
+SELECT ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03');
++-----------------------------------------------------------+
+| ADD_TIME('2025-10-10 11:22:33.1234567+03:00', '01:02:03') |
++-----------------------------------------------------------+
+| 2025-10-10 17:24:36.123457+08:00                          |
++-----------------------------------------------------------+
          
 -- NULL parameter test
 SELECT ADD_TIME(NULL, '01:00:00');
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
index 41c08751926bd..8ef445d557b50 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/sub-time.md
@@ -20,19 +20,20 @@ SUB_TIME(`<date_or_time_expr>`, `<time>`)
 
 | Parameter             | Description |
 | ---------------------| ----------- |
-| `<date_or_time_expr>`| A valid date expression. Supports input of datetime/date/time types. If the type is date, it will be converted to the start time of the day (00:00:00). For specific datetime/time formats, see [datetime conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [time conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/time-conversion). |
+| `<date_or_time_expr>`| A valid date expression. Supports input of timestamptz/datetime/date/time types. If the type is date, it will be converted to the start time of the day (00:00:00). For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [time conversion](../../../../../docs/sql-manual/basic-element/sql-data-types/conversion/time-conversion). |
 | `<time>`             | A valid time expression, representing the time value to be subtracted from `<date_or_time_expr>`. If negative, it means addition. Supports input of time type. |
 
 ## Return Value
 
 Returns the result of subtracting `<time>` from `<date_or_time_expr>`. The return type depends on the type of the first parameter:
+- If the first parameter is of timestamp type, returns timestamp type.
 - If the first parameter is of datetime type, returns datetime type.
 - If the first parameter is of time type, returns time type.
 
 Special cases:
 - If any input parameter is null, returns null.
 - If the first parameter is of time type and the result exceeds the time type range, returns the maximum (or minimum) time value.
-- If the first parameter is of datetime type and the result exceeds the datetime type range, an error is thrown.
+- If the first parameter is of datetime or timestamptz type and the result exceeds the datetime type range, an error is thrown.
 
 ## Examples
 
@@ -52,6 +53,14 @@ SELECT SUB_TIME(cast('12:15:20' as time), '00:10:40');
 +------------------------------------------------+
 | 12:04:40                                       |
 +------------------------------------------------+   
+
+-- SET time_zone = '+08:00'
+select sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123');
++------------------------------------------------------+
+| sub_time('2025-10-10 11:22:33+03:00', '3:22:33.123') |
++------------------------------------------------------+
+| 2025-10-10 12:59:59.877+08:00                        |
++------------------------------------------------------+
          
 -- NULL parameter test
 SELECT SUB_TIME(NULL, '01:00:00');

From edba8ca7cb4503e957938c2568e9ee91cdb3ca94 Mon Sep 17 00:00:00 2001
From: linzhenqi <linzhenqi@selectdb.com>
Date: Sun, 4 Jan 2026 16:25:37 +0800
Subject: [PATCH 2/3] DATE_ADD/SUB

---
 .../date-time-functions/date-add.md           | 13 +++++++++--
 .../date-time-functions/date-sub.md           | 13 +++++++++--
 .../date-time-functions/hours-add.md          | 17 +++++++++++---
 .../date-time-functions/hours-sub.md          | 17 +++++++++++---
 .../date-time-functions/microseconds-add.md   | 18 +++++++++++----
 .../date-time-functions/microseconds-sub.md   | 16 +++++++++----
 .../date-time-functions/minutes-add.md        | 17 +++++++++++---
 .../date-time-functions/minutes-sub.md        | 17 +++++++++++---
 .../date-time-functions/months-add.md         | 15 ++++++++----
 .../date-time-functions/months-sub.md         | 15 ++++++++----
 .../date-time-functions/quarters-add.md       | 17 ++++++++++----
 .../date-time-functions/quarters-sub.md       | 17 ++++++++++----
 .../date-time-functions/seconds-add.md        | 19 +++++++++++----
 .../date-time-functions/seconds-sub.md        | 19 +++++++++++----
 .../date-time-functions/weeks-add.md          | 21 +++++++++++++----
 .../date-time-functions/weeks-sub.md          | 21 +++++++++++++----
 .../date-time-functions/years-add.md          | 19 +++++++++++----
 .../date-time-functions/years-sub.md          | 19 +++++++++++----
 .../date-time-functions/date-add.md           | 13 +++++++++--
 .../date-time-functions/date-ceil.md          | 16 +++++++++++--
 .../date-time-functions/date-sub.md           | 17 ++++++++++----
 .../date-time-functions/hours-add.md          | 19 +++++++++++----
 .../date-time-functions/hours-sub.md          | 19 +++++++++++----
 .../date-time-functions/microseconds-add.md   | 20 ++++++++++++----
 .../date-time-functions/microseconds-sub.md   | 18 +++++++++++----
 .../date-time-functions/minutes-add.md        | 19 +++++++++++----
 .../date-time-functions/minutes-sub.md        | 19 +++++++++++----
 .../date-time-functions/months-add.md         | 15 ++++++++----
 .../date-time-functions/months-sub.md         | 15 ++++++++----
 .../date-time-functions/quarters-add.md       | 19 +++++++++++----
 .../date-time-functions/quarters-sub.md       |  8 +++++++
 .../date-time-functions/seconds-add.md        | 21 +++++++++++++----
 .../date-time-functions/seconds-sub.md        | 20 ++++++++++++----
 .../date-time-functions/weeks-add.md          | 20 ++++++++++++----
 .../date-time-functions/weeks-sub.md          | 23 ++++++++++++++-----
 .../date-time-functions/years-add.md          | 19 +++++++++++----
 .../date-time-functions/years-sub.md          | 19 +++++++++++----
 .../date-time-functions/date-add.md           | 15 +++++++++---
 .../date-time-functions/date-sub.md           | 17 ++++++++++----
 .../date-time-functions/hours-add.md          | 18 +++++++++++----
 .../date-time-functions/hours-sub.md          | 19 +++++++++++----
 .../date-time-functions/microseconds-add.md   | 20 ++++++++++++----
 .../date-time-functions/microseconds-sub.md   | 18 +++++++++++----
 .../date-time-functions/minutes-add.md        | 19 +++++++++++----
 .../date-time-functions/minutes-sub.md        | 19 +++++++++++----
 .../date-time-functions/months-add.md         | 15 ++++++++----
 .../date-time-functions/months-sub.md         | 15 ++++++++----
 .../date-time-functions/quarters-add.md       | 19 +++++++++++----
 .../date-time-functions/quarters-sub.md       | 17 ++++++++++----
 .../date-time-functions/seconds-add.md        | 21 +++++++++++++----
 .../date-time-functions/seconds-sub.md        | 20 ++++++++++++----
 .../date-time-functions/weeks-add.md          | 20 ++++++++++++----
 .../date-time-functions/weeks-sub.md          | 23 ++++++++++++++-----
 .../date-time-functions/years-add.md          | 19 +++++++++++----
 .../date-time-functions/years-sub.md          | 19 +++++++++++----
 .../date-time-functions/date-add.md           | 13 +++++++++--
 .../date-time-functions/date-sub.md           | 13 +++++++++--
 .../date-time-functions/hours-add.md          | 17 +++++++++++---
 .../date-time-functions/hours-sub.md          | 17 +++++++++++---
 .../date-time-functions/microseconds-add.md   | 18 +++++++++++----
 .../date-time-functions/microseconds-sub.md   | 16 +++++++++----
 .../date-time-functions/minutes-add.md        | 17 +++++++++++---
 .../date-time-functions/minutes-sub.md        | 17 +++++++++++---
 .../date-time-functions/months-add.md         | 15 ++++++++----
 .../date-time-functions/months-sub.md         | 15 ++++++++----
 .../date-time-functions/quarters-add.md       | 17 ++++++++++----
 .../date-time-functions/quarters-sub.md       | 19 +++++++++++----
 .../date-time-functions/seconds-add.md        | 19 +++++++++++----
 .../date-time-functions/seconds-sub.md        | 19 +++++++++++----
 .../date-time-functions/weeks-add.md          | 21 +++++++++++++----
 .../date-time-functions/weeks-sub.md          | 21 +++++++++++++----
 .../date-time-functions/years-add.md          | 19 +++++++++++----
 .../date-time-functions/years-sub.md          | 19 +++++++++++----
 73 files changed, 1001 insertions(+), 293 deletions(-)

diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
index 3fae7486f7ce5..5080df26a68ed 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
@@ -10,7 +10,7 @@
 
 The DATE_ADD function is used to add a specified time interval to a specified date or time value and return the calculated result.
 
-- Supported input date types include DATE, DATETIME (such as '2023-12-31', '2023-12-31 23:59:59').
+- Supported input date types include DATE, DATETIME, TIMESTAMPTZ (such as '2023-12-31', '2023-12-31 23:59:59', '2023-12-31 23:59:59+08:00').
 - The time interval is specified by both a numeric value (`expr`) and a unit (`time_unit`). When `expr` is positive, it means "add", and when it is negative, it is equivalent to "subtract" the corresponding interval.
 
 ## Aliases
@@ -28,7 +28,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
 
 | Parameter | Description |
 | -- | -- |
-| `<date_or_time_expr>` | The date/time value to be processed. Supported types: datetime or date type, with a maximum precision of six decimal places for seconds (e.g., 2022-12-28 23:59:59.999999). For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | The date/time value to be processed. Supported types: datetime or date type, with a maximum precision of six decimal places for seconds (e.g., 2022-12-28 23:59:59.999999). For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<expr>` | The time interval to be added, of `INT` type |
 | `<time_unit>` | Enumeration values: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR, MINUTE_SECOND, SECOND_MICROSECOND | 
 
@@ -37,6 +37,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
 Returns a result with the same type as <date_or_time_expr>:
 - When DATE type is input, returns DATE (date part only);
 - When DATETIME type input, returns DATETIME (including date and time);
+- WHEN TIMESTAMPTZ type input, returns TIMESTAMPTZ (including date, time, and timezone offset).
 - Input with scale (such as '2024-01-01 12:00:00.123') will preserve the scale, with a maximum of six decimal places.
 
 Special cases:
@@ -129,6 +130,14 @@ mysql>  select date_add("2025-10-10 10:10:10.123456", INTERVAL "1.1" SECOND_MICR
 | 2025-10-10 10:10:11.223456                                                |
 +---------------------------------------------------------------------------+
 
+-- Example of TimestampTz type, SET time_zone = '+08:00'
+select DATE_ADD('2023-01-01 23:22:33+03:00', INTERVAL 1 DAY);
++-------------------------------------------------------+
+| DATE_ADD('2023-01-01 23:22:33+03:00', INTERVAL 1 DAY) |
++-------------------------------------------------------+
+| 2023-01-03 04:22:33+08:00                             |
++-------------------------------------------------------+
+
 -- Illegal unit
 select DATE_ADD('2023-12-31 23:00:00', INTERVAL 2 sa);
 ERROR 1105 (HY000): errCode = 2, detailMessage = 
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
index 80e99653e0d0c..d9b334ce27937 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The DATE_SUB function is used to subtract a specified time interval from a given date or time value and return the calculated date or time result. It supports operations on DATE (date only) and DATETIME (date and time) types, where the time interval is defined by both a numerical value and a unit.
+The DATE_SUB function is used to subtract a specified time interval from a given date or time value and return the calculated date or time result. It supports operations on DATE (date only), DATETIME (date and time) and TIMESTAMPTZ(date, time, and timezone offset) types, where the time interval is defined by both a numerical value and a unit.
 
 This function behaves generally consistently with the [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) in MySQL, but the difference is that MySQL supports compound unit additions and subtractions, such as:
 
@@ -33,7 +33,7 @@ DATE_SUB(<date_or_time_part>, <expr> <time_unit>)
 
 | Parameter | Description |
 | -- | -- |
-| `<date_or_time_part>` | A valid date value, supporting datetime or date type. For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_part>` | A valid date value, supporting datetime or date type. For specificformats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<expr>` | The time interval to be subtracted, of type `INT` |
 | `<time_unit>` | Enumerated values: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND |
 
@@ -42,6 +42,7 @@ DATE_SUB(<date_or_time_part>, <expr> <time_unit>)
 Returns a calculated result with the same type as date:
 - When input is DATE, returns DATE (date part only);
 - When input is DATETIME, returns DATETIME (including date and time).
+- When input is TIMESTAMPTZ, returns TIMESTAMPTZ (including date, time, and timezone offset).
 - For datetime types with scale, the scale will be preserved and returned.
 
 Special cases:
@@ -101,6 +102,14 @@ mysql> select date_sub('2023-12-31 23:59:59', INTERVAL 61 QUARTER);
 | 2008-09-30 23:59:59                                  |
 +------------------------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT DATE_SUB('2024-02-05 02:03:04.123+12:00', INTERVAL 1 DAY);
++-----------------------------------------------------------+
+| DATE_SUB('2024-02-05 02:03:04.123+12:00', INTERVAL 1 DAY) |
++-----------------------------------------------------------+
+| 2024-02-03 22:03:04.123+08:00                             |
++-----------------------------------------------------------+
+
 -- Any parameter is NULL
 mysql> select date_sub('2023-01-01', INTERVAL NULL DAY);
 +-------------------------------------------+
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
index 09af01b5d3cdd..ab9f076984a41 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The HOURS_ADD function adds or subtracts a specified number of hours to/from an input date or datetime value and returns the calculated new datetime. This function supports both DATE and DATETIME input types. If the input is DATE type (containing only year, month, day), it defaults the time part to 00:00:00 before adding hours.
+The HOURS_ADD function adds or subtracts a specified number of hours to/from an input date or datetime value and returns the calculated new datetime. This function supports both DATE, DATETIME and TIMESTAMPTZ input types. If the input is DATE type (containing only year, month, day), it defaults the time part to 00:00:00 before adding hours.
 
 This function is consistent with the [date_add function](./date-add) and [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) in MySQL when using the `HOUR` unit.
 
@@ -22,13 +22,16 @@ HOURS_ADD(`<date_or_time_expr>`, `<hours>`)
 
 | Parameter | Description |
 | ---- | ---- |
-| `<date_or_time_expr>` | A valid date expression that supports date/datetime types. For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | A valid date expression that supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<hours>` | The number of hours to add, of integer (INT) type. Can be positive or negative: positive number adds the specified hours, negative number subtracts the specified hours (equivalent to subtracting hours) |
 
 ## Return Value
 
-Returns DATETIME type, representing the time value after adding or subtracting the specified number of hours from the input datetime.
+Return the base time `<date_or_time_expr>` plus the specified hours `<hours>`, the return value type is determined by the type of the first parameter:
+- If the type of the first parameter is DATE/DATETIME, then the return type is DATETIME.
+- If the type of the first parameter is TIMESTAMPTZ, then the return type is TIMESTAMPTZ.
 
+Special cases:
 - If the calculation result exceeds the valid range of DATETIME type [0000-01-01 00:00:01, 9999-12-31 23:59:59], returns an error.
 - Return NULL if any parameters is NULL.
 
@@ -60,6 +63,14 @@ select hours_add('2023-10-01 10:00:00', -3) ;
 | 2023-10-01 07:00:00                  |
 +--------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT HOURS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| HOURS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-10 13:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- Input parameter is NULL, return NULL
 select hours_add(null, 5) ;
 +--------------------+
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
index eaeb265d8b5b3..2593e7bf47399 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The HOURS_SUB function subtracts a specified number of hours from an input date or datetime value and returns the calculated new datetime. This function supports both DATE and DATETIME input types. If the input is DATE type (containing only year, month, day), it defaults the time part to 00:00:00.
+The HOURS_SUB function subtracts a specified number of hours from an input date or datetime value and returns the calculated new datetime. This function supports both DATE, DATETIME and TIMESTAMPTZ input types. If the input is DATE type (containing only year, month, day), it defaults the time part to 00:00:00.
 
 This function is consistent with the [date_sub function](./date-sub) and [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) in MySQL when using the `HOUR` unit.
 
@@ -22,13 +22,16 @@ HOURS_SUB(`<date_or_time_expr>`, `<hours>`)
 
 | Parameter | Description |
 | ---- | ---- |
-| `<date_or_time_expr>` | A valid date expression that supports date/datetime types. For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | A valid date expression that supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<hours>` | The number of hours to subtract, of INT type |
 
 ## Return Value
 
-Returns a DATETIME type value representing the datetime after adding or subtracting the specified hours (format: YYYY-MM-DD HH:MM:SS).
+Return the base time `<date_or_time_expr>` minus the specified hours `<hours>`, the return value type is determined by the type of the first parameter:
+- If the type of the first parameter is DATE/DATETIME, then the return type is DATETIME.
+- If the type of the first parameter is TIMESTAMPTZ, then the return type is TIMESTAMPTZ
 
+Special cases:
 - If the calculation result exceeds the valid range of DATETIME type (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns an error.
 - If any input parameter is NULL, returns NULL.
 - If input hours is negative, returns the datetime plus the corresponding number of hours.
@@ -61,6 +64,14 @@ select hours_sub('2023-10-01 10:00:00', -3);
 | 2023-10-01 13:00:00                  |
 +--------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT HOURS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| HOURS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-10 11:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- Any parameter is NULL, return NULL
 select hours_sub('2023-10-01 10:00:00', NULL);
 +----------------------------------------+
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
index 7e9c3f3a72227..cd2e22747f9f9 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
@@ -8,26 +8,28 @@
 
 ## Description
 
-The MICROSECONDS_ADD function adds a specified number of microseconds to the input datetime value and returns the resulting new datetime value. This function supports processing DATETIME types with microsecond precision.
+The MICROSECONDS_ADD function adds a specified number of microseconds to the input datetime value and returns the resulting new datetime value. This function supports processing DATETIME or TIMESTAMPTZ types with microsecond precision.
 
 This function behaves the same as MySQL’s [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) when using MICROSECOND as the unit.
 
 ## Syntax
 
 ```sql
-MICROSECONDS_ADD(`<datetime>`, `<delta>`)
+MICROSECONDS_ADD(`<datetime_like_type>`, `<delta>`)
 ```
 
 ## Parameters
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<datetime>` | The input datetime value, of type DATETIME. For datetime formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
+| `<datetime_like_type>` | The input datetime value, of type DATETIME or TIMESTAMPTZ. For formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
 | `<delta>` | The number of microseconds to add, of type BIGINT. 1 second = 1,000,000 microseconds. |
 
 ## Return Value
 
-Returns a DATETIME type value, representing the result of adding the specified microseconds to the base time (formatted as YYYY-MM-DD HH:MM:SS.ffffff, where the fractional part precision matches the datetime precision).
+Return the result of adding the specified microseconds `<delta>` to the base time `<datetime_like_type>`, with the return type being the same as the type of the first parameter.
+- If the first parameter is TIMESTAMPTZ, then return TIMESTAMPTZ.
+- If the first parameter is DATETIME, then return DATETIME.
 
 - If `<delta>` is negative, the function subtracts the corresponding microseconds from the base time (i.e., MICROSECONDS_ADD(basetime, -n) is equivalent to MICROSECONDS_SUB(basetime, n)).
 - If the calculation result exceeds the valid range of the DATETIME type (0000-01-01 00:00:00 to 9999-12-31 23:59:59.999999), an exception is thrown.
@@ -61,6 +63,14 @@ SELECT MICROSECONDS_ADD('2023-10-01', -300000);
 | 2023-09-30 23:59:59.700000              |
 +-----------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MICROSECONDS_ADD('2024-12-25 12:34:56.123+04:00', '765800');
++-------------------------------------------------------------+
+| MICROSECONDS_ADD('2024-12-25 12:34:56.123+04:00', '765800') |
++-------------------------------------------------------------+
+| 2024-12-25 16:34:56.888800+08:00                            |
++-------------------------------------------------------------+
+
 -- Calculation result exceeds datetime range, throws error
 SELECT MICROSECONDS_ADD('9999-12-31 23:59:59.999999', 2000000) AS after_add;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 9999-12-31 23:59:59.999999, 2000000 out of range
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
index 1351e075b3d23..d4f2c4f666e0a 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
@@ -8,26 +8,26 @@
 
 ## Description
 
-The `MICROSECONDS_SUB` function subtracts a specified number of microseconds from the input datetime value and returns the resulting new datetime value. This function supports processing `DATETIME` types with microsecond precision.
+The `MICROSECONDS_SUB` function subtracts a specified number of microseconds from the input datetime value and returns the resulting new datetime value. This function supports processing `DATETIME` and `TIMESTAMPTZ` types with microsecond precision.
 
 This function behaves the same as MySQL’s [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) when using MICROSECOND as the unit.
 
 ## Syntax
 
 ```sql
-MICROSECONDS_SUB(`<datetime>`, `<delta>`)
+MICROSECONDS_SUB(`<datetime_like_type>`, `<delta>`)
 ```
 
 ## Parameters
 
 | Parameter    | Description                                                                                     |
 |--------------|-------------------------------------------------------------------------------------------------|
-| `<datetime>` | The input datetime value, of type `DATETIME`. For specific datetime formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion). |
+| `<datetime_like_type>` | The input datetime value, of type `DATETIME` or `TIMESTAMPTZ`. For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion). |
 | `<delta>`    | The number of microseconds to subtract, of type `BIGINT`. 1 second = 1,000,000 microseconds.       |
 
 ## Return Value
 
-Returns a value of type `DATETIME`, representing the result of subtracting the specified number of microseconds from the base time.
+Return the result of subtracting the specified microseconds `<delta>` from the base time `<datetime_like_type>`, with the return type being the same as the type of the first parameter.
 
 - If `<delta>` is negative, the function behaves the same as adding the corresponding number of microseconds to the base time (i.e., `MICROSECONDS_SUB(basetime, -n)` is equivalent to `MICROSECONDS_ADD(basetime, n)`).
 - If the calculation result exceeds the valid range of the `DATETIME` type (`0000-01-01 00:00:00` to `9999-12-31 23:59:59.999999`), an exception is thrown.
@@ -69,6 +69,14 @@ SELECT MICROSECONDS_SUB('2023-10-01', -300000);
 | 2023-10-01 00:00:00.300000              |
 +-----------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800');
++-------------------------------------------------------------+
+| MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800') |
++-------------------------------------------------------------+
+| 2024-12-25 16:34:55.357200+08:00                            |
++-------------------------------------------------------------+
+
 -- Exceeds datetime range, throws an error
 mysql> SELECT MICROSECONDS_SUB('0000-01-01 00:00:00.000000', 1000000) AS after_sub;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 0000-01-01 00:00:00, -1000000 
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
index 2ad6166ab1240..19054c2d672fe 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The MINUTES_ADD function adds a specified number of minutes to the input datetime value and returns the resulting new datetime value. This function supports processing DATE and DATETIME types.
+The MINUTES_ADD function adds a specified number of minutes to the input datetime value and returns the resulting new datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types.
 
 This function is consistent with [date_add function](./date-add) and MySQL's [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) when using MINUTE as the unit.
 
@@ -22,13 +22,16 @@ MINUTES_ADD(`<date_or_time_expr>`, `<minutes>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input datetime value, which can be of type DATE or DATETIME. For specific datetime/date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | The input datetime value, which can be of type DATE, DATETIME or TIMESTAMPTZ. For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<minutes>` | The number of minutes to add, of type BIGINT. |
 
 ## Return Value
 
-Returns a value of type DATETIME, representing the result of adding the specified minutes to the base time.
+Return the result of adding the specified minutes `<minutes>` to the base time `<datetime_like_type>`, with the return type related to the first parameter type:
+- If the first parameter is TIMESTAMPTZ, then return TIMESTAMPTZ.
+- If the first parameter is DATETIME, then return DATETIME.
 
+Special cases:
 - If `<minutes>` is negative, the function behaves the same as subtracting the corresponding minutes from the base time (i.e., MINUTES_ADD(date, -n) is equivalent to MINUTES_SUB(date, n)).
 - If the input is of DATE type (only includes year, month, and day), its time part defaults to 00:00:00.
 - If the input datetime includes microseconds, the original microsecond precision is preserved after adding minutes (e.g., '2023-01-01 00:00:00.123456' becomes '2023-01-01 00:01:00.123456' after adding 1 minute).
@@ -70,6 +73,14 @@ SELECT MINUTES_ADD('2023-07-13 22:28:18', -5) AS result;
 | 2023-07-13 22:23:18 |
 +---------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:23:33.123+08:00                   |
++-------------------------------------------------+
+
 -- Any parameter is NULL, returns NULL
 SELECT MINUTES_ADD(NULL, 10), MINUTES_ADD('2023-07-13 22:28:18', NULL) AS result;
 +-------------------------+--------+
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
index eab65d88513f7..4a09415cff071 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The MINUTES_SUB function subtracts a specified number of minutes from the input datetime value and returns the resulting new datetime value. This function supports processing DATE and DATETIME types.
+The MINUTES_SUB function subtracts a specified number of minutes from the input datetime value and returns the resulting new datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types.
 
 This function is consistent with [date_sub function](./date-sub) and MySQL's [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) when using MINUTE as the unit.
 
@@ -22,13 +22,16 @@ MINUTES_SUB(`<date_or_time_expr>`, `<minutes>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input datetime value, which can be of type DATE or DATETIME. For specific datetime/date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
+| `<date_or_time_expr>` | The input datetime value, which can be of type DATE, DATETIME or TIMESTAMPTZ. For specific datetime/date formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
 | `<minutes>` | The number of minutes to subtract, of type BIGINT. Can be positive or negative. |
 
 ## Return Value
 
-Returns a value of type DATETIME, representing the datetime value after subtracting the specified number of minutes.
+Return the result of subtracting the specified minutes `<minutes>` from the base time `<datetime_like_type>`, with the return type being related to the type of the first parameter:
+- If the first parameter is TIMESTAMPTZ, then return TIMESTAMPTZ.
+- If the first parameter is DATETIME, then return DATETIME.
 
+Special cases:
 - If `<minutes>` is negative, the function behaves the same as adding the corresponding minutes to the base time (i.e., MINUTES_SUB(date, -n) is equivalent to MINUTES_ADD(date, n)).
 - If the input is of DATE type (only includes year, month, and day), its time part defaults to 00:00:00.
 - If the input datetime includes microseconds, the original microsecond precision is preserved after subtracting minutes (e.g., '2023-01-01 00:01:00.123456' becomes '2023-01-01 00:00:00.123456' after subtracting 1 minute).
@@ -70,6 +73,14 @@ SELECT MINUTES_SUB('2023-07-13', 30) AS result;
 | 2023-07-12 23:30:00 |
 +---------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MINUTES_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| MINUTES_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:21:33.123+08:00                   |
++-------------------------------------------------+
+
 -- Any parameter is NULL, returns NULL
 SELECT MINUTES_SUB(NULL, 10), MINUTES_SUB('2023-07-13 22:28:18', NULL) AS result;
 +-----------------------+--------+
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
index 6ef7acd6f0358..64922a46484ed 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The MONTHS_ADD function adds a specified number of months to the input datetime value and returns the resulting new datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to subtracting the corresponding number of months.
+The MONTHS_ADD function adds a specified number of months to the input datetime value and returns the resulting new datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types. If a negative number is input, it is equivalent to subtracting the corresponding number of months.
 
 This function is consistent with [date_add function](./date-add) and MySQL's [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) when using MONTH as the unit.
 
@@ -22,15 +22,14 @@ MONTHS_ADD(`<date_or_time_expr>`, `<nums>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input datetime value. Supports date/datetime types. For specific datetime and date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
+| `<date_or_time_expr>` | The input datetime value. Supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
 | `<nums>` | The number of months to add or subtract, of type INT. Negative numbers indicate subtracting nums months from the datetime, positive numbers indicate adding nums months. |
 
 ## Return Value
 
-Returns a value of the same type as the input `<date_or_time_expr>` (DATE or DATETIME), representing the result of adding the specified months to the base time.
+Returns a value of the same type as the input `<date_or_time_expr>`(DATE, DATETIME or TIMESTAMPTZ), representing the result of adding the specified months to the base time.
 
 - If `<nums>` is negative, the function behaves the same as subtracting the corresponding months from the base time (i.e., MONTHS_ADD(date, -n) is equivalent to MONTHS_SUB(date, n)).
-- If the input is of DATE type (only includes year, month, and day), the result remains of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-01-01 12:34:56' becomes '2023-02-01 12:34:56' after adding 1 month).
 - If the input date is the last day of the month and the target month has fewer days than that date, it automatically adjusts to the last day of the target month (e.g., January 31st plus 1 month becomes February 28th or 29th, depending on whether it's a leap year).
 - If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns an error.
 - If any parameter is NULL, returns NULL.
@@ -78,6 +77,14 @@ SELECT MONTHS_ADD('2023-07-13 22:28:18.456789', 3) AS result;
 | 2023-10-13 22:28:18.456789 |
 +----------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MONTHS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++------------------------------------------------+
+| MONTHS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++------------------------------------------------+
+| 2025-11-10 12:22:33.123+08:00                  |
++------------------------------------------------+
+
 -- Returns NULL when input is NULL
 SELECT MONTHS_ADD(NULL, 5), MONTHS_ADD('2023-07-13', NULL) AS result;
 +----------------------+--------+
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
index 4de90b66ce022..0f1039e18deb1 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The MONTHS_SUB function subtracts a specified number of months from the input datetime value and returns the resulting new datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to adding the corresponding number of months.
+The MONTHS_SUB function subtracts a specified number of months from the input datetime value and returns the resulting new datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types. If a negative number is input, it is equivalent to adding the corresponding number of months.
 
 This function is consistent with [date_sub function](./date-sub) and MySQL's [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_sub) when using MONTH as the unit.
 
@@ -22,15 +22,14 @@ MONTHS_SUB(`<date_or_time_expr>`, `<nums>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The date value from which to subtract months. Supports date/datetime types. For specific datetime and date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | The date value from which to subtract months. Supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<nums>` | The number of months to subtract, of type INT. Positive numbers indicate subtracting nums months from the datetime, negative numbers indicate adding nums months. |
 
 ## Return Value
 
-Returns a value of the same type as the input `<date_or_time_expr>` (DATE or DATETIME), representing the result of subtracting the specified months from the base time.
+Returns a value of the same type as the input `<date_or_time_expr>`(DATE, DATETIME or TIMESTAMPTZ), representing the result of subtracting the specified months from the base time.
 
 - If `<nums>` is negative, the function behaves the same as adding the corresponding months to the base time (i.e., MONTHS_SUB(date, -n) is equivalent to MONTHS_ADD(date, n)).
-- If the input is of DATE type (only includes year, month, and day), the result remains of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-03-01 12:34:56' becomes '2023-02-01 12:34:56' after subtracting 1 month).
 - If the input date is the last day of the month and the target month has fewer days than that date, it automatically adjusts to the last day of the target month (e.g., March 31st minus 1 month becomes February 28th or 29th, depending on whether it's a leap year).
 - If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns an error.
 - If any parameter is NULL, returns NULL.
@@ -86,6 +85,14 @@ SELECT MONTHS_SUB(NULL, 5), MONTHS_SUB('2023-07-13', NULL) AS result;
 | NULL                 | NULL   |
 +----------------------+--------+
 
+--- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MONTHS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++------------------------------------------------+
+| MONTHS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++------------------------------------------------+
+| 2025-09-10 12:22:33.123+08:00                  |
++------------------------------------------------+
+
 --- Calculation result exceeds date range
 mysql> SELECT MONTHS_SUB('0000-01-01', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation months_add of 0000-01-01, -1 out of range
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
index f1e098635dc44..77fd42a35a1fd 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The QUARTERS_ADD function is used to add or subtract a specified number of quarters (1 quarter = 3 months) to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to subtracting the corresponding number of quarters.
+The QUARTERS_ADD function is used to add or subtract a specified number of quarters (1 quarter = 3 months) to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to subtracting the corresponding number of quarters. This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function is consistent with the [date_add function](./date-add) when using QUARTER as the unit.
 
@@ -22,14 +22,15 @@ QUARTERS_ADD(`<date_or_time_expr>`, `<quarters>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input date or datetime value. Supports date/datetime types. For specific datetime and date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
+| `<date_or_time_expr>` | The input date or datetime value. Supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
 | `<quarters>` | The number of quarters to add or subtract. Positive integers indicate addition, negative integers indicate subtraction. |
 
 ## Return Value
 
-Returns a date value consistent with the input date type.
+Returns a date value consistent with the input date type, the return value type is determined by the type of the first parameter:
 - If `<quarters>` is negative, the function behaves the same as subtracting the corresponding number of quarters from the base time (i.e., QUARTERS_ADD(date, -n) is equivalent to QUARTERS_SUB(date, n)).
-- If the input is of DATE type (only includes year, month, and day), the result remains of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-01-01 12:34:56' becomes '2023-04-01 12:34:56' after adding 1 quarter).
+- If the input is of DATE type (only includes year, month, and day), the result is of DATE type; if the input is of DATETIME type, the result is of DATETIME type and preserves the original time component (e.g., '2023-01-01 12:34:56' becomes '2023-04-01 12:34:56' after adding 1 quarter).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
 - If the input date is the last day of the month and the target month has fewer days than that date, it automatically adjusts to the last day of the target month (e.g., January 31st plus 1 quarter (3 months) becomes April 30th).
 - If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59), throws an exception.
 - If any parameter is NULL, returns NULL.
@@ -93,6 +94,14 @@ SELECT QUARTERS_ADD(NULL, 1), QUARTERS_ADD('2023-07-13', NULL) AS result;
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+--- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT QUARTERS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++--------------------------------------------------+
+| QUARTERS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++--------------------------------------------------+
+| 2026-01-10 12:22:33.123+08:00                    |
++--------------------------------------------------+
+
 --- Calculation result exceeds date range
 SELECT QUARTERS_ADD('9999-10-31', 2) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation month_add of 9999-10-31, 6 out of range
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
index 40666721794cb..ad8aada24b2b8 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The QUARTERS_SUB function is used to subtract or add a specified number of quarters (1 quarter = 3 months) to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to adding the corresponding number of quarters.
+The QUARTERS_SUB function is used to subtract or add a specified number of quarters (1 quarter = 3 months) from a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to adding the corresponding number of quarters. This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function behaves consistently with the [date_sub function](./date-sub) when using QUARTER as the unit.
 
@@ -22,15 +22,16 @@ QUARTERS_SUB(`<date_or_time_expr>`, `<quarters>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input date or datetime value. Supports date/datetime types. For specific datetime and date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
+| `<date_or_time_expr>` | The input date or datetime value. Supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
 | `<quarters>` | The number of quarters to add or subtract. Positive integers indicate subtraction, negative integers indicate addition. |
 
 ## Return Value
 
-Returns a date value consistent with the input date type.
+Returns a date value consistent with the input date type, the return value type is determined by the type of the first parameter:
 
 - If `<quarters>` is negative, the function behaves the same as adding the corresponding number of quarters to the base time (i.e., QUARTERS_SUB(date, -n) is equivalent to QUARTERS_ADD(date, n)).
-- If the input is of DATE type (only includes year, month, and day), the result remains of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-04-01 12:34:56' becomes '2023-01-01 12:34:56' after subtracting 1 quarter).
+- If the input is of DATE type (only includes year, month, and day), the result is of DATE type; if the input is of DATETIME type, the result is of DATETIME type and preserves the original time component (e.g., '2023-04-01 12:34:56' becomes '2023-01-01 12:34:56' after subtracting 1 quarter).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
 - If the input date is the last day of the month and the target month has fewer days than that date, it automatically adjusts to the last day of the target month (e.g., April 30th minus 1 quarter (3 months) becomes January 31st).
 - If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59), throws an exception.
 - If any parameter is NULL, returns NULL.
@@ -94,6 +95,14 @@ SELECT QUARTERS_SUB(NULL, 1), QUARTERS_SUB('2023-07-13', NULL) AS result;
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+--- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT QUARTERS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++--------------------------------------------------+
+| QUARTERS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++--------------------------------------------------+
+| 2025-07-10 12:22:33.123+08:00                    |
++--------------------------------------------------+
+
 --- Calculation result exceeds date range
 SELECT QUARTERS_SUB('0000-04-30', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation quarters_sub of 0000-04-30, 1 out of range
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
index b84f1e96b38b7..d81bbcf943c4c 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The SECONDS_ADD function adds or subtracts a specified number of seconds to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to subtracting the corresponding number of seconds.
+The SECONDS_ADD function adds or subtracts a specified number of seconds to a specified datetime value and returns the calculated datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types. If a negative number is input, it is equivalent to subtracting the corresponding number of seconds.
 
 This function is consistent with [date_add function](./date-add) and MySQL's [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) when using SECOND as the unit.
 
@@ -22,16 +22,19 @@ SECONDS_ADD(<date_or_time_expr>, <seconds>)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | Required. The input datetime value. Can be of type DATE or DATETIME. For specific datetime/date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | Required. The input datetime value. Can be of type DATE, DATETIME or TIMESTAMPTZ. For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<seconds>` | Required. The number of seconds to add or subtract. Supports integer type (BIGINT). Positive numbers indicate adding seconds, negative numbers indicate subtracting seconds. |
 
 ## Return Value
 
-Returns a datetime value with the same type as the input `<date_or_time_expr>`.
+Return the base time `<date_or_time_expr>` by adding the specified number of seconds `<second>`, the return value type is determined by the type of the first parameter:
+- If the type of the first parameter is DATE/DATETIME, then the return type is DATETIME.
+- If the type of the first parameter is TIMESTAMPTZ, then the return type is TIMESTAMPTZ.
 
+Special cases:
 - If `<seconds>` is negative, the function behaves the same as subtracting the corresponding seconds from the base time (i.e., SECONDS_ADD(date, -n) is equivalent to SECONDS_SUB(date, n)).
 - If the input is DATE type (only contains year, month, day), its time portion defaults to 00:00:00.
-- If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59.999999), returns an error.
+- If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME/TIMESTAMPTZ type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59.999999), returns an error.
 - If any parameter is NULL, returns NULL.
 
 ## Examples
@@ -77,6 +80,14 @@ SELECT SECONDS_ADD('2023-07-13 10:30:25.123456', 2) AS result;
 | 2023-07-13 10:30:27.123456 |
 +----------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:22:34.123+08:00                   |
++-------------------------------------------------+
+
 --- Returns NULL when input is NULL
 SELECT SECONDS_ADD(NULL, 30), SECONDS_ADD('2025-01-23 12:34:56', NULL) AS result;
 +-------------------------+--------+
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
index 5ee94e5727ecb..217f350697396 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The SECONDS_SUB function subtracts or adds a specified number of seconds to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to adding the corresponding number of seconds.
+The SECONDS_SUB function subtracts or adds a specified number of seconds to a specified datetime value and returns the calculated datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types. If a negative number is input, it is equivalent to adding the corresponding number of seconds.
 
 This function is consistent with [date_sub function](./date-sub) and MySQL's [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) when using SECOND as the unit.
 
@@ -22,13 +22,16 @@ SECONDS_SUB(<date_or_time_expr>, <seconds>)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | Required. The input datetime value. Can be of type DATE or DATETIME. For specific datetime/date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | Required. The input datetime value. Can be of type DATE, DATETIME or TIMESTAMPTZ. For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<seconds>` | Required. The number of seconds to subtract or add. Supports integer type (BIGINT). Positive numbers indicate subtracting seconds, negative numbers indicate adding seconds. |
 
 ## Return Value
 
-Returns a datetime value after adding the corresponding seconds to the input datetime, of type DATETIME.
-
+Returns the value of the base time `<date_or_time_expr>` minus the specified number of seconds `<second>`, and the return type is determined by the type of the first parameter:
+- If the type of the first parameter is DATE/DATETIME, it returns a DATETIME type.
+- If the type of the first parameter is TIMESTAMPTZ, it returns a TIMESTAMPTZ type.
+  
+Special cases:
 - If `<seconds>` is negative, the function behaves the same as adding the corresponding seconds to the base time (i.e., SECONDS_SUB(date, -n) is equivalent to SECONDS_ADD(date, n)).
 - If the input is DATE type (only contains year, month, day), its time portion defaults to 00:00:00.
 - If the calculation result exceeds the valid range of the date type (for DATE type: throws an exception).
@@ -77,6 +80,14 @@ SELECT SECONDS_SUB('2023-07-13 10:30:25.123456', 2) AS result;
 | 2023-07-13 10:30:23.123456 |
 +----------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT SECONDS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| SECONDS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:22:32.123+08:00                   |
++-------------------------------------------------+
+
 --- Returns NULL when input is NULL
 SELECT SECONDS_SUB(NULL, 30), SECONDS_SUB('2025-01-23 12:34:56', NULL) AS result;
 +-------------------------+--------+
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
index ede88bc749c39..2c09aa7fc6299 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
@@ -8,7 +8,7 @@
 
 ## Description 
 
-The WEEKS_ADD function is used to add (or subtract) a specified number of weeks to a given date or time value, equivalent to adding/subtracting seven days to the original date, returning the adjusted date or time.
+The WEEKS_ADD function is used to add (or subtract) a specified number of weeks to a given date or time value, equivalent to adding/subtracting seven days to the original date, returning the adjusted date or time. This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function behaves consistently with the [weeks_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_weeks-add) using WEEK as the unit in MySQL.
 
@@ -20,15 +20,18 @@ WEEKS_ADD(`<datetime_or_date_expr>`, `<weeks_value>`)
 ## Parameters
 | Parameter | Description |
 |-----------|-------------|
-| `<datetime_or_date_expr>` | Input datetime value, supports date/datetime types. For datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<datetime_or_date_expr>` | Input datetime value, supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<weeks_value>` | INT type integer, representing the number of weeks to add or subtract (positive for addition, negative for subtraction) |
 
 ## Return Value
 
-Returns the datetime with the specified number of weeks added.
+Returns the datetime with the specified number of weeks added, the return value type is determined by the type of the first parameter:
 
-- If input is DATE type, return value remains DATE type (only adjusts year, month, day).
-- If input is DATETIME type, return value remains DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is DATE type, return value is DATE type (only adjusts year, month, day).
+- If input is DATETIME type, return value is DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
+
+Special cases:
 - `<weeks_value>` as negative number indicates subtracting weeks.
 - Any input parameter is NULL, returns NULL
 - If calculation result exceeds valid date type range (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns error
@@ -74,6 +77,14 @@ SELECT WEEKS_ADD(NULL, 5) AS null_input;
 +------------+
 | NULL       |
 +------------+
+
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT WEEKS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| WEEKS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-17 12:22:33.123+08:00                 |
++-----------------------------------------------+
 ```
 
 
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
index a709ab5c36806..91d4e0a77cc84 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
@@ -7,7 +7,7 @@
 ---
 
 ## Description
-The WEEKS_SUB function is used to subtract (or add) a specified number of weeks from a given date or time value, returning the adjusted date or time (essentially subtracting weeks_value × 7 days). It supports processing DATE and DATETIME types.
+The WEEKS_SUB function is used to subtract (or add) a specified number of weeks from a given date or time value, returning the adjusted date or time (essentially subtracting weeks_value × 7 days). It supports processing DATE, DATETIME and TIMESTAMPTZ types.
 
 This function is consistent with the [weeks_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_weeks-sub) using WEEK as the unit in MySQL.
 
@@ -19,14 +19,17 @@ WEEKS_SUB(`<date_or_time_expr>`, `<week_period>`)
 ## Parameters
 | Parameter | Description |
 |-----------|-------------|
-| `<date_or_time_expr>` | Input datetime value, supports date/datetime types. For datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | Input datetime value, supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `week_period` | INT type integer, representing the number of weeks to subtract (positive for subtraction, negative for addition). |
 
 ## Return Value
-Returns the date or time with the specified number of weeks subtracted:
+Returns the date or time with the specified number of weeks subtracted, the return value type is determined by the type of the first parameter:
 
-- If input is DATE type, return value remains DATE type (only adjusts year, month, day).
-- If input is DATETIME type, return value remains DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is DATE type, return value is DATE type (only adjusts year, month, day).
+- If input is DATETIME type, return value is DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
+
+Special cases:
 - `<weeks_value>` as negative number indicates adding weeks (equivalent to WEEKS_ADD(`<datetime_or_date_value>`, `<weeks_value>`)).
 - Any input parameter is NULL, returns NULL.
 - If calculation result exceeds valid date type range (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns error.
@@ -73,6 +76,14 @@ SELECT WEEKS_SUB(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT WEEKS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| WEEKS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-03 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- The calculation result exceeds the lower bound of the datetime range.
 SELECT WEEKS_SUB('0000-01-01', 1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation weeks_add of 0000-01-01, -1 out of range
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
index babb31bf14754..931be53893c28 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The YEARS_ADD function is used to add (or subtract) a specified number of years to a given date or time value, returning the adjusted date or time. It supports processing DATE and DATETIME types, where the number of years can be positive (addition) or negative (subtraction).
+The YEARS_ADD function is used to add (or subtract) a specified number of years to a given date or time value, returning the adjusted date or time. It supports processing DATE and DATETIME types, where the number of years can be positive (addition) or negative (subtraction). This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function is consistent with the [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) using YEAR as the unit in MySQL.
 
@@ -22,16 +22,17 @@ YEARS_ADD(`<date_or_time_expr>`, `<years>`)
 
 | Parameter | Description |
 |-----------|-------------|
-| `<date_or_time_expr>` | Input datetime value, supports date/datetime types. For datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | Input datetime value, supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<years>` | Number of years to add, type INT, negative numbers indicate subtraction, positive numbers indicate addition |
 
 
 ## Return Value
 
-Returns a result consistent with the input type (DATE or DATETIME), representing the adjusted date or time:
+Returns a result consistent with the input type (DATE or DATETIME or TIMESTAMPTZ), representing the adjusted date or time, the return value type is determined by the type of the first parameter:
 
-- If input is DATE type, return value remains DATE type (only adjusts year, month, day).
-- If input is DATETIME type, return value remains DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is DATE type, return value is DATE type (only adjusts year, month, day).
+- If input is DATETIME type, return value is DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
 - `<years_value>` as negative number indicates subtracting years (equivalent to YEARS_SUB(`<datetime_or_date_value>`, `<years_value>`)).
 - Any input parameter is NULL, returns NULL.
 - If calculation result exceeds valid date type range (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns error.
@@ -88,6 +89,14 @@ SELECT YEARS_ADD(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT YEARS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| YEARS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2026-10-10 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- Calculation result exceeds datetime range (upper limit)
 SELECT YEARS_ADD('9999-12-31', 1);
 -- ERROR: Operation out of range
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
index 52b881fbb6d56..66a19eb5e2a53 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The YEARS_SUB function is used to subtract (or add) a specified number of years from a given date or time value, returning the adjusted date or time (essentially subtracting years_value × 1 year). It supports processing DATE and DATETIME types, where the number of years can be positive (subtraction) or negative (addition).
+The YEARS_SUB function is used to subtract (or add) a specified number of years from a given date or time value, returning the adjusted date or time (essentially subtracting years_value × 1 year). It supports processing DATE and DATETIME types, where the number of years can be positive (subtraction) or negative (addition). This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function behaves consistently with the [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) using YEAR as the unit in MySQL.
 
@@ -22,15 +22,16 @@ YEARS_SUB(`<date_or_time_expr>`, `<years>`)
 
 | Parameter | Description |
 |-----------|-------------|
-| `<date_or_time_expr>` | Input datetime value, supports date/datetime types. For datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
+| `<date_or_time_expr>` | Input datetime value, supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
 | `<years>` | Number of years to subtract, type INT, positive numbers indicate subtraction, negative numbers indicate addition |
 
 ## Return Value
 
-Returns a result consistent with the input type (DATE or DATETIME), representing the adjusted date or time:
+Returns a result consistent with the input type (DATE or DATETIME or TIMESTAMPTZ), representing the adjusted date or time, the return value type is determined by the type of the first parameter:
 
-- If input is DATE type, return value remains DATE type (only adjusts year, month, day).
-- If input is DATETIME type, return value remains DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is DATE type, return value is DATE type (only adjusts year, month, day).
+- If input is DATETIME type, return value is DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
 - `<years_value>` as negative number indicates adding years (equivalent to YEARS_ADD(`<datetime_or_date_value>`, `<years_value>`)).
 - Any input parameter is NULL, returns NULL.
 - If calculation result exceeds valid date type range (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns error.
@@ -79,6 +80,14 @@ SELECT YEARS_SUB(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT YEARS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| YEARS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2024-10-10 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- Calculation result exceeds datetime range (upper limit)
 SELECT YEARS_SUB('9999-12-31', -1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation year_add of 9999-12-31, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
index 6d2c429122b9b..dfc58b6b31dc3 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
@@ -10,7 +10,7 @@
 
 DATE_ADD 函数用于向指定的日期或时间值添加指定的时间间隔，并返回计算后的结果。
 
-- 支持的输入日期类型包括 DATE、DATETIME（如 '2023-12-31'、'2023-12-31 23:59:59'）。
+- 支持的输入日期类型包括 DATE、DATETIME、TIMESTAMPTZ（如 '2023-12-31'、'2023-12-31 23:59:59'、'2023-12-31 23:59:59+08:00'）。
 - 时间间隔由数值（`expre`）和单位（`time_unit`）共同指定，`expr` 为正数时表示“添加”，为负数时等效于“减去”对应间隔。
 
 ## 别名
@@ -28,7 +28,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 待处理的日期/时间值。支持类型：为 datetime 或者 date 类型，最高有六位秒数的精度（如 2022-12-28 23:59:59.999999），具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion))|
+| `<date_or_time_expr>` | 待处理的日期/时间值。支持类型：为 timestamptz, datetime 或者 date 类型，最高有六位秒数的精度（如 2022-12-28 23:59:59.999999），具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<expr>` | 希望添加的时间间隔，为 `INT` 类型|
 | `<time_unit>` | 枚举值：YEAR, QUARTER, MONTH, WEEK,DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR, MINUTE_SECOND, SECOND_MICROSECOND |
 
@@ -37,6 +37,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
 返回与 <date_or_time_expr> 类型一致的结果：
 - 输入 DATE 类型时，返回 DATE（仅日期部分）；
 - 输入 DATETIME 类型，返回 DATETIME（包含日期和时间）；
+- 输入 TIMESTAMPTZ 类型，返回 TIMESTAMPTZ(包含日期，时间和时区偏移量);
 - 带有 scale 的输入（如 '2024-01-01 12:00:00.123'）会保留 scale，最高六位小数精度。
 
 特殊情况：
@@ -128,6 +129,14 @@ mysql>  select date_add("2025-10-10 10:10:10.123456", INTERVAL "1.1" SECOND_MICR
 | 2025-10-10 10:10:11.223456                                                |
 +---------------------------------------------------------------------------+
 
+-- TimestampTz类型示例, SET time_zone = '+08:00'
+select DATE_ADD('2023-01-01 23:22:33+03:00', INTERVAL 1 DAY);
++-------------------------------------------------------+
+| DATE_ADD('2023-01-01 23:22:33+03:00', INTERVAL 1 DAY) |
++-------------------------------------------------------+
+| 2023-01-03 04:22:33+08:00                             |
++-------------------------------------------------------+
+
 ---非法单位
 select DATE_ADD('2023-12-31 23:00:00', INTERVAL 2 sa);
 ERROR 1105 (HY000): errCode = 2, detailMessage = 
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-ceil.md
index a6daa61f1714e..8914ec5a1fe7d 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-ceil.md
@@ -30,7 +30,7 @@ $type$ 代表的是周期单位
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入为 datetime 或者 date 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion))|
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入为 timestamptz, datetime 或者 date 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<period>` | 参数是指定每个周期有多少个单位组成，类型为 INT, 开始的时间起点为 0001-01-01T00:00:00 |
 | `<type>` | 参数可以是：YEAR, QUARTER, MONTH, WEEK ,DAY, HOUR, MINUTE, SECOND|
 
@@ -40,7 +40,8 @@ $type$ 代表的是周期单位
 返回与 datetime 类型一致的取整结果：
 - 输入 DATE 类型时，返回 DATE（仅日期部分）；
 - 输入 DATETIME 类型，返回 DATETIME（包含日期和时间）。
-- 对于带有 scale 的 datetime, 返回值也会带有 scale， 小数部分为零.
+- 输出 TIMESTAMPTZ 类型，返回 TIMESTAMPTZ（包含日期、时间和偏移量）。
+- 对于不带有 scale 的 datetime和timestamptz, 返回值也会带有 scale， 小数部分为零.
 
 特殊情况：
 - 任何参数为 NULL 时，返回 NULL；
@@ -114,6 +115,17 @@ select date_ceil("2023-07-13 22:28:18",interval 5 year);
 | 2023-12-01 00:00:00                                         |
 +-------------------------------------------------------------+
 
+-- 会话变量中的时区为: '+08:00'
+-- '2025-12-31 23:59:59+05:00' 对应的本地时间为 '2026-01-01 02:59:59'
+-- 对本地
+SELECT DATE_CEIL('2025-12-31 23:59:59+05:00', INTERVAL 1 YEAR);
++---------------------------------------------------------+
+| DATE_CEIL('2025-12-31 23:59:59+05:00', INTERVAL 1 YEAR) |
++---------------------------------------------------------+
+| 2027-01-01 00:00:00                                     |
++---------------------------------------------------------+
+
+
 -- 超过最大年数
 mysql> select date_ceil("9999-07-13",interval 5 year);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation year_ceil of 9999-07-13 00:00:00, 5 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
index 3797aa8328943..7a511dd512e1f 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
@@ -2,13 +2,13 @@
 {
     "title": "DATE_SUB",
     "language": "zh-CN",
-    "description": "DATESUB 函数用于从指定的日期或时间值中减去指定的时间间隔，返回计算后的日期或时间结果。该函数支持对 DATE（仅日期）和 DATETIME（日期和时间）类型进行操作，时间间隔通过数值和单位共同定义。"
+    "description": "DATE_SUB 函数用于从指定的日期或时间值中减去指定的时间间隔，返回计算后的日期或时间结果。该函数支持对 DATE（仅日期）, DATETIME（日期和时间）TIMESTAMPTZ(带时区偏移量的日期时间)类型进行操作，时间间隔通过数值和单位共同定义。"
 }
 ---
 
 ## 描述
 
-DATE_SUB 函数用于从指定的日期或时间值中减去指定的时间间隔，返回计算后的日期或时间结果。该函数支持对 DATE（仅日期）和 DATETIME（日期和时间）类型进行操作，时间间隔通过数值和单位共同定义。
+DATE_SUB 函数用于从指定的日期或时间值中减去指定的时间间隔，返回计算后的日期或时间结果。该函数支持对 DATE（仅日期）, DATETIME（日期和时间）TIMESTAMPTZ(带时区偏移量的日期时间)类型进行操作，时间间隔通过数值和单位共同定义。
 
 该函数与 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 行为大致一致，但不同的是，mysql 支持联合单位的增减，如:
 
@@ -33,7 +33,7 @@ DATE_ADD(<date_or_time_part>, <expr> <time_unit>)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_part>` | 合法的日期值，支持为 datetime 或者 date 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)) |
+| `<date_or_time_part>` | 合法的日期值，支持为 timestamptz, datetime 或者 date 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<expr>` | 希望减去的时间间隔，类型为 `INT` |
 | `<time_unit>` | 枚举值：YEAR，QUARTER，MONTH，WEEK，DAY，HOUR，MINUTE，SECOND |
 
@@ -42,6 +42,7 @@ DATE_ADD(<date_or_time_part>, <expr> <time_unit>)
 返回与 date 类型一致的计算结果：
 - 输入 DATE 类型时，返回 DATE（仅日期部分）；
 - 输入 DATETIME 类型时，返回 DATETIME（包含日期和时间）。
+- 输入 TIMESTAMPTZ 类型时, 返回 TIMESTAMPTZ（包含日期，时间和时区偏移量）。
 - 对于带有 scale 的 datetime 类型，会保留 scale 返回。
 
 特殊情况：
@@ -109,7 +110,15 @@ mysql> select date_sub('2023-01-01', INTERVAL NULL DAY);
 | NULL                                      |
 +-------------------------------------------+
 
---非法单位，返回粗我
+-- TimeStampTz 类型示例，SET time_zone = '+08:00'
+SELECT DATE_SUB('2024-02-05 02:03:04.123+12:00', INTERVAL 1 DAY);
++-----------------------------------------------------------+
+| DATE_SUB('2024-02-05 02:03:04.123+12:00', INTERVAL 1 DAY) |
++-----------------------------------------------------------+
+| 2024-02-03 22:03:04.123+08:00                             |
++-----------------------------------------------------------+
+
+--非法单位，返回错误
 mysql> select date_sub('2022-01-01', INTERVAL 1 Y);
 ERROR 1105 (HY000): errCode = 2, detailMessage = 
 mismatched input 'Y' expecting {'.', '[', 'AND', 'BETWEEN', 'COLLATE', 'DAY', 'DIV', 'HOUR', 'IN', 'IS', 'LIKE', 'MATCH', 'MATCH_ALL', 'MATCH_ANY', 'MATCH_PHRASE', 'MATCH_PHRASE_EDGE', 'MATCH_PHRASE_PREFIX', 'MATCH_REGEXP', 'MINUTE', 'MONTH', 'NOT', 'OR', 'QUARTER', 'REGEXP', 'RLIKE', 'SECOND', 'WEEK', 'XOR', 'YEAR', EQ, '<=>', NEQ, '<', LTE, '>', GTE, '+', '-', '*', '/', '%', '&', '&&', '|', '||', '^'}(line 1, pos 41)
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
index a382c619f1dd5..c02ba0583cf91 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
@@ -2,13 +2,13 @@
 {
     "title": "HOURS_ADD",
     "language": "zh-CN",
-    "description": "HOURSADD 函数用于在输入的日期或日期时间值上增加或减少指定的小时数，并返回计算后的新日期时间。该函数支持 DATE 和 DATETIME 两种输入类型,若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型，再进行小时累加。"
+    "description": "HOURS_ADD 函数用于在输入的日期或日期时间值上增加或减少指定的小时数，并返回计算后的新日期时间。该函数支持 DATE, DATETIME 和 TIMESTAMPTZ 作为输入类型,若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型，再进行小时累加。"
 }
 ---
 
 ## 描述
 
-HOURS_ADD 函数用于在输入的日期或日期时间值上增加或减少指定的小时数，并返回计算后的新日期时间。该函数支持 DATE 和 DATETIME 两种输入类型,若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型，再进行小时累加。
+HOURS_ADD 函数用于在输入的日期或日期时间值上增加或减少指定的小时数，并返回计算后的新日期时间。该函数支持 DATE, DATETIME 和 TIMESTAMPTZ 作为输入类型,若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型，再进行小时累加。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 中的 [date_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) 使用 `HOUR` 单位的行为一致。
 
@@ -22,13 +22,16 @@ HOURS_ADD(`<date_or_time_expr>`, `<hours>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime 类型，具体 datetime,date格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<hours>` | 	要增加的小时数，类型为整数（INT），可正可负：正数：增加指定小时，负数：减少指定小时（等效于减去小时）。 |
 
 ## 返回值
 
-返回类型为 DATETIME，返回以输入日期时间为基准，增加或减小指定小时数后的时间值。
+返回基准时间`<date_or_time_expr>`加上指定小时`<hours>`的值，返回值类型由第一个参数类型决定:
+- 若第一个参数类型为 DATE/DATETIME, 则返回 DATETIME 类型。
+- 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。
 
+特殊情况:
 - 若计算结果超出 DATETIME 类型的有效范围 [0000-01-01 00:00:01,9999-12-31 23:59:59]，返回 错误。
 - 任意一个参数为 NULL， 返回 NULL
 
@@ -60,6 +63,14 @@ select hours_add('2023-10-01 10:00:00', -3) ;
 | 2023-10-01 07:00:00                  |
 +--------------------------------------+
 
+-- TimeStampTz 类型示例, SET time_zone = '+08:00'
+SELECT HOURS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| HOURS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-10 13:22:33.123+08:00                 |
++-----------------------------------------------+
+
 ---输入参数为 NULL,返回 NULL
 select hours_add(null, 5) ;
 +--------------------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
index 6d5cb3ce95343..bd8b0ceb7ba5b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
@@ -2,13 +2,13 @@
 {
     "title": "HOURS_SUB",
     "language": "zh-CN",
-    "description": "HOURSSUB 函数用于从输入的日期或日期时间值中减去指定的小时数，并返回计算后的新日期时间。该函数支持 DATE 和 DATETIME 两种输入类型，若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型。"
+    "description": "HOURS_SUB 函数用于从输入的日期或日期时间值中减去指定的小时数，并返回计算后的新日期时间。该函数支持 DATE, DATETIME 和 TIMESTAMPTZ 作为输入类型，若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型。"
 }
 ---
 
 ## 描述
 
-HOURS_SUB 函数用于从输入的日期或日期时间值中减去指定的小时数，并返回计算后的新日期时间。该函数支持 DATE 和 DATETIME 两种输入类型，若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型。
+HOURS_SUB 函数用于从输入的日期或日期时间值中减去指定的小时数，并返回计算后的新日期时间。该函数支持 DATE, DATETIME 和 TIMESTAMPTZ 作为输入类型，若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型。
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 使用 `HOUR` 单位的行为一致。
 
@@ -22,13 +22,16 @@ HOURS_SUB(`<date_or_time_expr>`, `<hours>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime 类型，具体 datetime,date格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<hours>` | 要减去的小时数，类型为 INT |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示加上或减去指定小时后的日期时间（格式为 YYYY-MM-DD HH:MM:SS）
+返回基准时间`<date_or_time_expr>`减去指定小时`<hours>`的值，返回值类型由第一个参数类型决定:
+- 若第一个参数类型为 DATE/DATETIME, 则返回 DATETIME 类型。
+- 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。
 
+特殊情况:
 - 若计算结果超出 DATETIME 类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
 - 输入任一参数为 NULL，返回 NULL
 - 输入 hours 为负数，返回日期时间加上对应小时数
@@ -61,6 +64,14 @@ select hours_sub('2023-10-01 10:00:00', -3);
 | 2023-10-01 13:00:00                  |
 +--------------------------------------+
 
+-- TimeStampTz 类型示例, SET time_zone = '+08:00'
+SELECT HOURS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| HOURS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-10 11:22:33.123+08:00                 |
++-----------------------------------------------+
+
 ---任意参数为 NULL ,返回 NULL
 select hours_sub('2023-10-01 10:00:00', NULL);
 +----------------------------------------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
index 74e02a31a3262..6a78b1fd1d6b6 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
@@ -2,13 +2,13 @@
 {
     "title": "MICROSECONDS_ADD",
     "language": "zh-CN",
-    "description": "MICROSECONDSADD 函数用于向输入的日期时间值中添加指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 类型。"
+    "description": "MICROSECONDS_ADD 函数用于向输入的日期时间值中添加指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 或 TIMESTAMPTZ 类型。"
 }
 ---
 
 ## 描述
 
-MICROSECONDS_ADD 函数用于向输入的日期时间值中添加指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 类型。
+MICROSECONDS_ADD 函数用于向输入的日期时间值中添加指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 或 TIMESTAMPTZ 类型。
 
 
 该函数与 mysql 中的 [date_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) 使用 MICROSECOND 为单位的行为一致。
@@ -16,19 +16,21 @@ MICROSECONDS_ADD 函数用于向输入的日期时间值中添加指定的微秒
 ## 语法
 
 ```sql
-MICROSECONDS_ADD(`<datetime>`, `<delta>`)
+MICROSECONDS_ADD(`<datetime_like_type>`, `<delta>`)
 ```
 
 ## 参数
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<datetime>` | 输入的日期时间值，类型为 DATETIME，具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)  |
+| `<datetime_like_type>` | 输入的日期时间值，类型为 DATETIME 或 TIMESTAMPTZ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)  |
 | `<delta>` | 要添加的微秒数，类型为 BIGINT，1 秒 = 1,000,000 微秒 |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示基准时间添加指定微秒后的结果（格式为 YYYY-MM-DD HH:MM:SS.ffffff，其中小数部分精度与 datetime 一致）。
+返回基准时间`<datetime_like_type>`添加指定微秒`<delta>`后的结果，返回类型与第一个参数类型相同
+- 若第一个参数为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ。
+- 若第一个参数为 DATETIME, 则返回 DATETIME。
 
 - 若 `<delta>` 为负数，函数效果等同于从基准时间中减去对应微秒数（即 MICROSECONDS_ADD(basetime, -n) 等价于 MICROSECONDS_SUB(basetime, n)）。
 - 若计算结果超出 DATETIME 类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999），抛出异常。
@@ -62,6 +64,14 @@ SELECT MICROSECONDS_ADD('2023-10-01', -300000);
 | 2023-09-30 23:59:59.700000              |
 +-----------------------------------------+
 
+-- TimeStampTz 类型测试, SET time_zone = '+08:00'
+SELECT MICROSECONDS_ADD('2024-12-25 12:34:56.123+04:00', '765800');
++-------------------------------------------------------------+
+| MICROSECONDS_ADD('2024-12-25 12:34:56.123+04:00', '765800') |
++-------------------------------------------------------------+
+| 2024-12-25 16:34:56.888800+08:00                            |
++-------------------------------------------------------------+
+
 ---计算结果超过日期时间范围，报错
 SELECT MICROSECONDS_ADD('9999-12-31 23:59:59.999999', 2000000) AS after_add;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 9999-12-31 23:59:59.999999, 2000000 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
index 1b82856622d65..38602dc69b0dc 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
@@ -2,32 +2,32 @@
 {
     "title": "MICROSECONDS_SUB",
     "language": "zh-CN",
-    "description": "MICROSECONDSSUB 函数用于从输入的日期时间值中减去指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 类型。"
+    "description": "MICROSECONDSSUB 函数用于从输入的日期时间值中减去指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 和 TIMESTAMPTZ 类型。"
 }
 ---
 
 ## 描述
 
-MICROSECONDS_SUB 函数用于从输入的日期时间值中减去指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 类型。
+MICROSECONDS_SUB 函数用于从输入的日期时间值中减去指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 和TIMESTAMPTZ 类型。
 
 该函数与 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 使用 MICROSECOND 为单位的行为一致。
 
 ## 语法
 
 ```sql
-MICROSECONDS_SUB(`<datetime>`, `<delta>`)
+MICROSECONDS_SUB(`<datetime_like_type>`, `<delta>`)
 ```
 
 ## 参数
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<datetime>` | 输入的日期时间值，类型为 DATETIME，具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
+| `<datetime_like_type>` | 输入的日期时间值，类型为 DATETIME 或 TIMESTAMPTZ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
 | `<delta>` | 要减去的微秒数，类型为 BIGINT，1 秒 = 1,000,000 微秒 |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示基准时间减去指定微秒后的结果。
+返回基准时间`<datetime_like_type>`减去指定微秒`<delta>`后的结果，返回类型与第一个参数类型相同
 
 - 若 `<delta>` 为负数，函数效果等同于向基准时间中添加对应微秒数（即 MICROSECONDS_SUB(basetime, -n) 等价于 MICROSECONDS_ADD(basetime, n)）。
 - 若计算结果超出 DATETIME 类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999），抛出异常。
@@ -69,6 +69,14 @@ SELECT MICROSECONDS_SUB('2023-10-01', -300000);
 | 2023-10-01 00:00:00.300000              |
 +-----------------------------------------+
 
+-- TimeStampTz 类型测试, SET time_zone = '+08:00'
+SELECT MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800');
++-------------------------------------------------------------+
+| MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800') |
++-------------------------------------------------------------+
+| 2024-12-25 16:34:55.357200+08:00                            |
++-------------------------------------------------------------+
+
 ---超出日期时间范围，抛出错误
 mysql> SELECT MICROSECONDS_SUB('0000-01-01 00:00:00.000000', 1000000) AS after_sub;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 0000-01-01 00:00:00, -1000000 
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
index d7cdc7d4b5536..49c799c28d450 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
@@ -2,13 +2,13 @@
 {
     "title": "MINUTES_ADD",
     "language": "zh-CN",
-    "description": "MINUTESADD 函数用于向输入的日期时间值中添加指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型。"
+    "description": "MINUTESADD 函数用于向输入的日期时间值中添加指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ类型。"
 }
 ---
 
 ## 描述
 
-MINUTES_ADD 函数用于向输入的日期时间值中添加指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型。
+MINUTES_ADD 函数用于向输入的日期时间值中添加指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ类型。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 的 [date-add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) 使用 MINUTE 为单位的行为一致。
 
@@ -22,13 +22,16 @@ MINUTES_ADD(`<date_or_time_expr>`, `<minutes>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| ``<date_or_time_expr>`` | 输入的日期时间值，类型可以是 DATE、DATETIME ，具体 datetime/date 请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion), |
+| ``<date_or_time_expr>`` | 输入的日期时间值，类型可以是 DATE、DATETIME、TIMESTAMPTZ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion), |
 | ``<minutes>`` | 要增加的分钟数，类型为 BIGINT，可以为正数或负数 |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示基准时间添加指定分钟后的结果。
+返回基准时间`<datetime_like_type>`添加指定分钟`<minutes>`后的结果，返回类型与第一个参数类型相关:
+- 若第一个参数为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ。
+- 若第一个参数为 DATETIME, 则返回 DATETIME。
 
+特殊情况:
 - 若 `<minutes>` 为负数，函数效果等同于从基准时间中减去对应分钟数（即 MINUTES_ADD(date, -n) 等价于 MINUTES_SUB(date, n)）。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00。
 - 若输入的日期时间包含微秒部分，添加分钟后会保留原微秒精度（如 '2023-01-01 00:00:00.123456' 添加 1 分钟后为 '2023-01-01 00:01:00.123456'）。
@@ -70,6 +73,14 @@ SELECT MINUTES_ADD('2023-07-13 22:28:18', -5) AS result;
 | 2023-07-13 22:23:18 |
 +---------------------+
 
+-- TimeStampTz 类型测试, SET time_zone = '+08:00'
+SELECT MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:23:33.123+08:00                   |
++-------------------------------------------------+
+
 --- 任一参数为 NULL，返回 NULL
 SELECT MINUTES_ADD(NULL, 10), MINUTES_ADD('2023-07-13 22:28:18', NULL) AS result;
 +-------------------------+--------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
index 9ba1b8d20e237..903eb4f537a93 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
@@ -2,13 +2,13 @@
 {
     "title": "MINUTES_SUB",
     "language": "zh-CN",
-    "description": "MINUTESSUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型."
+    "description": "MINUTESSUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ类型."
 }
 ---
 
 ## 描述
 
-MINUTES_SUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型.
+MINUTES_SUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ类型.
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 的 [date-add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) 使用 MINUTE 为单位的行为一致。
 
@@ -22,14 +22,17 @@ MINUTES_SUB(`<date_or_time_expr>`, `<minutes>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| ``<date_or_time_expr>`` | 输入的日期时间值，类型可以是 DATE、DATETIME ，具体 datetime/date 请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| ``<date_or_time_expr>`` | 输入的日期时间值，类型可以是 DATE、DATETIME、TIMESTAMPTZ ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | ``<minutes>`` | 要减去的分钟数，类型为 BIGINT，可以为正数或负数 |
 
 ## 返回值
 
 
-返回类型为 DATETIME，表示减去指定分钟数后的日期时间值。
+返回基准时间`<datetime_like_type>`减去指定分钟`<minutes>`后的结果，返回类型与第一个参数类型相关:
+- 若第一个参数为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ。
+- 若第一个参数为 DATETIME, 则返回 DATETIME。
 
+特殊情况:
 - 若 `<minutes>` 为负数，函数效果等同于向基准时间中添加对应分钟数（即 MINUTES_SUB(date, -n) 等价于 MINUTES_ADD(date, n)）。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00。
 - 若输入的日期时间包含微秒部分，减去分钟后会保留原微秒精度（如 '2023-01-01 00:01:00.123456' 减去 1 分钟后为 '2023-01-01 00:00:00.123456'）。
@@ -73,6 +76,14 @@ SELECT MINUTES_SUB('2023-07-13', 30) AS result;
 | 2023-07-12 23:30:00 |
 +---------------------+
 
+-- TimeStampTz 类型测试, SET time_zone = '+08:00'
+SELECT MINUTES_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| MINUTES_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:21:33.123+08:00                   |
++-------------------------------------------------+
+
 --- 任一参数为 NULL，返回 NULL
 SELECT MINUTES_SUB(NULL, 10), MINUTES_SUB('2023-07-13 22:28:18', NULL) AS result;
 +-----------------------+--------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
index 5469a353e7095..1dda7db6c360e 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-MONTHS_ADD 函数用于向输入的日期时间值中添加指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于减去对应月份数。
+MONTHS_ADD 函数用于向输入的日期时间值中添加指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME 和 TIMESTAMPTZ 类型，若输入负数则等效于减去对应月份数。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 的 [date-add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) 使用 MONTH 为单位的行为一致。
 
@@ -22,14 +22,13 @@ MONTHS_ADD(`<date_or_time_expr>`, `<nums>`)
 
 | 参数                | 说明            |
 |-------------------|---------------|
-| ``<date_or_time_expr>`` | 输入的日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
+| ``<date_or_time_expr>`` | 输入的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
 | ``<nums>``          | 需要加减的月份数 ,为 INT 类型，负数表示日期时间减去 nums 月份，正数表示加上 nums 月份   |
 
 ## 返回值
-返回与输入 `<date_or_time_expr>` 同类型的值（DATE 或 DATETIME），表示基准时间添加指定月份后的结果。
+返回与输入 `<date_or_time_expr>` 同类型的值(DATE, DATETIME 或 TIMESTAMPTZ)，表示基准时间添加指定月份后的结果。
 
 - 若 `<months>` 为负数，函数效果等同于从基准时间中减去对应月份数（即 MONTHS_ADD (date, -n) 等价于 MONTHS_SUB (date, n)）。
-- 若输入为 DATE 类型（仅包含年月日），返回结果仍为 DATE 类型；若输入为 DATETIME 类型，返回结果保留原时间部分（如 '2023-01-01 12:34:56' 添加 1 个月后为 '2023-02-01 12:34:56'）。
 - 若输入日期为当月最后一天，且目标月份天数少于该日期，则自动调整为目标月份的最后一天（如 1 月 31 日加 1 个月为 2 月 28 日或 29 日，具体取决于是否为闰年）。
 - 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
 - 若任一参数为 NULL，返回 NULL。
@@ -86,6 +85,14 @@ SELECT MONTHS_ADD(NULL, 5), MONTHS_ADD('2023-07-13', NULL) AS result;
 | NULL                 | NULL   |
 +----------------------+--------+
 
+--- TimestampTz 类型示例，SET time_zone = '+08:00'
+SELECT MONTHS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++------------------------------------------------+
+| MONTHS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++------------------------------------------------+
+| 2025-11-10 12:22:33.123+08:00                  |
++------------------------------------------------+
+
 --- 计算结果超出日期范围
 mysql> SELECT MONTHS_ADD('9999-12-31', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation months_add of 9999-12-31, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
index ef98c11d4ef9d..766b064f5d180 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-MONTHS_SUB 函数用于从输入的日期时间值中减去指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于添加对应月份数。
+MONTHS_SUB 函数用于从输入的日期时间值中减去指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME 和 TIMESTAMPTZ 类型，若输入负数则等效于添加对应月份数。
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 的 [date-sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_sub) 使用 MONTH 为单位的行为一致。
 
@@ -22,15 +22,14 @@ MONTHS_SUB(`<date_or_time_expr>`  `<nums>`)
 
 | 参数                | 说明            |
 |-------------------|---------------|
-| ``<date_or_time_expr>`` | 需要被计算加减月份的日期值,支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| ``<date_or_time_expr>`` | 需要被计算加减月份的日期值,支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | ``<nums>``          |需要减去的月份数，为 INT 类型，正数表示日期时间减去 nums 月份，负数表示加上 nums 月份 |
 
 ## 返回值
 
-返回与输入 `<date_or_time_expr>` 同类型的值（DATE 或 DATETIME），表示基准时间减去指定月份后的结果。
+返回与输入 `<date_or_time_expr>` 同类型的值 (DATE, DATETIME 或 TIMESTAMPTZ)，表示基准时间减去指定月份后的结果。
 
 - 若 `<nums>` 为负数，函数效果等同于向基准时间中添加对应月份数（即 MONTHS_SUB (date, -n) 等价于 MONTHS_ADD (date, n)）。
-- 若输入为 DATE 类型（仅包含年月日），返回结果仍为 DATE 类型；若输入为 DATETIME 类型，返回结果保留原时间部分（如 '2023-03-01 12:34:56' 减去 1 个月后为 '2023-02-01 12:34:56'）。
 - 若输入日期为当月最后一天，且目标月份天数少于该日期，则自动调整为目标月份的最后一天（如 3 月 31 日减 1 个月为 2 月 28 日或 29 日，具体取决于是否为闰年）。
 - 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
 - 若任一参数为 NULL，返回 NULL。
@@ -87,6 +86,14 @@ SELECT MONTHS_SUB(NULL, 5), MONTHS_SUB('2023-07-13', NULL) AS result;
 | NULL                 | NULL   |
 +----------------------+--------+
 
+--- TimestampTz 类型示例，SET time_zone = '+08:00'
+SELECT MONTHS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++------------------------------------------------+
+| MONTHS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++------------------------------------------------+
+| 2025-09-10 12:22:33.123+08:00                  |
++------------------------------------------------+
+
 --- 计算结果超出日期范围
 mysql> SELECT MONTHS_SUB('0000-01-01', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation months_add of 0000-01-01, -1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
index aa11685d64011..f1fe767d00873 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
@@ -7,7 +7,7 @@
 ---
 
 ## 描述
-QUARTERS_ADD 函数用于在指定的日期时间值基础上增加或减少指定的季度数（1 个季度 = 3 个月），并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于减去对应季度数。
+QUARTERS_ADD 函数用于在指定的日期时间值基础上增加或减少指定的季度数（1 个季度 = 3 个月）,并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型,若输入负数则等效于减去对应季度数。该函数支持 DATE、DATETIME 和 TIMESTAMPTZ 输入类型。
 
 该函数与 [date_add 函数](./date-add) 使用 QUARTER 为单位行为一致。
 
@@ -21,13 +21,14 @@ QUARTERS_ADD(`<date_or_time_expr>`, `<quarters>`)
 
 | 参数                | 说明                                 |
 |-------------------|------------------------------------|
-| ``<date_or_time_expr>`` | 输入的日期或日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)。 |
+| ``<date_or_time_expr>`` | 输入的日期或日期时间值,支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion),[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)。 |
 | ``<quarters>``      | 要增加或减少的季度数，正整数表示增加，负整数表示减少。        |
 
 ## 返回值
-返回一个日期值，与输入的日期类型一致。
-- 若 `<quarters>` 为负数，函数效果等同于从基准时间中减去对应季度数（即 QUARTERS_ADD(date, -n) 等价于 QUARTERS_SUB(date, n)）。
-- 若输入为 DATE 类型（仅包含年月日），返回结果仍为 DATE 类型；若输入为 DATETIME 类型，返回结果保留原时间部分（如 '2023-01-01 12:34:56' 加 1 个季度后为 '2023-04-01 12:34:56'）。
+返回一个日期值,与输入的日期类型一致,返回值类型由第一个参数的类型决定:
+- 若 `<quarters>` 为负数,函数效果等同于从基准时间中减去对应季度数（即 QUARTERS_ADD(date, -n) 等价于 QUARTERS_SUB(date, n)）。
+- 若输入为 DATE 类型（仅包含年月日）,返回结果为 DATE 类型；若输入为 DATETIME 类型,返回结果为 DATETIME 类型保留原时间部分（如 '2023-01-01 12:34:56' 加 1 个季度后为 '2023-04-01 12:34:56'）。
+- 若输入为 TIMESTAMPTZ 类型,返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移）。
 - 若输入日期为当月最后一天，且目标月份天数少于该日期，则自动调整为目标月份的最后一天（如 1 月 31 日加 1 个季度（3 个月）为 4 月 30 日）。
 - 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59），抛出异常。
 - 若任一参数为 NULL，返回 NULL。
@@ -91,6 +92,14 @@ SELECT QUARTERS_ADD(NULL, 1), QUARTERS_ADD('2023-07-13', NULL) AS result;
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+--- TimestampTz 类型示例,SET time_zone = '+08:00'
+SELECT QUARTERS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++--------------------------------------------------+
+| QUARTERS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++--------------------------------------------------+
+| 2026-01-10 12:22:33.123+08:00                    |
++--------------------------------------------------+
+
 --- 计算结果超出日期范围
 SELECT QUARTERS_ADD('9999-10-31', 2) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation month_add of 9999-10-31, 6 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
index 9d9dec2be97b5..68e82747ddd6c 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
@@ -94,6 +94,14 @@ SELECT QUARTERS_SUB(NULL, 1), QUARTERS_SUB('2023-07-13', NULL) AS result;
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+--- TimestampTz 类型示例,SET time_zone = '+08:00'
+SELECT QUARTERS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++--------------------------------------------------+
+| QUARTERS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++--------------------------------------------------+
+| 2025-07-10 12:22:33.123+08:00                    |
++--------------------------------------------------+
+
 --- 计算结果超出日期范围
 SELECT QUARTERS_SUB('0000-04-30', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation quarters_sub of 0000-04-30, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
index d942aabf04127..597d78c927c66 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
@@ -2,12 +2,12 @@
 {
     "title": "SECONDS_ADD",
     "language": "zh-CN",
-    "description": "SECONDSADD 函数用于在指定的日期时间值上增加或减少指定的秒数，并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于减去对应秒数。"
+    "description": "SECONDSADD 函数用于在指定的日期时间值上增加或减少指定的秒数，并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ 类型，若输入负数则等效于减去对应秒数。"
 }
 ---
 
 ## 描述
-SECONDS_ADD 函数用于在指定的日期时间值上增加或减少指定的秒数，并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于减去对应秒数。
+SECONDS_ADD 函数用于在指定的日期时间值上增加或减少指定的秒数，并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ 类型，若输入负数则等效于减去对应秒数。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 中的 [date_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) 使用 SECOND 为单位的行为一致
 
@@ -20,16 +20,19 @@ SECONDS_ADD(<date_or_time_expr>, <seconds>)
 
 | 参数           | 说明                                          |
 |--------------|---------------------------------------------|
-| `<date_or_time_expr>` | 必填，输入的日期时间值，类型可以是 DATE、DATETIME ，具体 datetime/date 请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)           |
+| `<date_or_time_expr>` | 必填，输入的日期时间值，类型可以是 DATE、DATETIME、TIMESTAMPTZ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)           |
 | `<seconds>`  | 必填，要增加或减少的秒数，支持整数类型（BIGINT）。正数表示增加秒数，负数表示减少秒数。 |
 
 ## 返回值
 
-返回一个日期时间值，类型与输入的 <date_or_time_expr> 类型一致。
+返回基准时间`<date_or_time_expr>`添加指定秒数`<second>`的值，返回值类型由第一个参数类型决定:
+- 若第一个参数类型为 DATE/DATETIME, 则返回 DATETIME 类型。
+- 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。
 
+特殊情况：
 - 若 <seconds> 为负数，函数效果等同于从基准时间中减去对应秒数（即 SECONDS_ADD(date, -n) 等价于 SECONDS_SUB(date, n)）。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00/
-- 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999），返回错误。
+- 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME/TIMESTAMPTZ 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999），返回错误。
 - 若任一参数为 NULL，返回 NULL。
 
 
@@ -75,6 +78,14 @@ SELECT SECONDS_ADD('2023-07-13 10:30:25.123456', 2) AS result;
 | 2023-07-13 10:30:27.123456 |
 +----------------------------+
 
+-- TimeStampTz 类型示例, SET time_zone = '+08:00'
+SELECT SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:22:34.123+08:00                   |
++-------------------------------------------------+
+
 --- 输入为 NULL 时返回 NULL
 SELECT SECONDS_ADD(NULL, 30), SECONDS_ADD('2025-01-23 12:34:56', NULL) AS result;
 +-------------------------+--------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
index b77d8bc0b63a9..d93535d51baf7 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
@@ -2,12 +2,12 @@
 {
     "title": "SECONDS_SUB",
     "language": "zh-CN",
-    "description": "SECONDSSUB 函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于增加对应秒数。"
+    "description": "SECONDSSUB 函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ 类型，若输入负数则等效于增加对应秒数。"
 }
 ---
 
 ## 描述
-SECONDS_SUB 函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于增加对应秒数。
+SECONDS_SUB 函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ 类型，若输入负数则等效于增加对应秒数。
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 使用 SECOND 为单位的行为一致
 
@@ -20,12 +20,16 @@ SECONDS_SUB(<date_or_time_expr>, <seconds>)
 
 | 参数           | 说明                                          |
 |--------------|---------------------------------------------|
-| `<date_or_time_expr>` | 必填，输入的日期时间值，类型可以是 DATE、DATETIME ，具体 datetime/date 请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)        |
+| `<date_or_time_expr>` | 必填，输入的日期时间值，类型可以是 DATE、DATETIME、TIMESTAMPTZ ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)        |
 | `<seconds>`  | 必填，要减少或增加的秒数，支持整数类型（BIGINT）。正数表示增加秒数，负数表示减少秒数。 |
 
 ## 返回值
 
-返回一个输入日期时间增加对应秒数后的日期时间值，类型为 DATETIME
+返回基准时间`<date_or_time_expr>`减去指定秒数`<second>`的值，返回值类型由第一个参数类型决定:
+- 若第一个参数类型为 DATE/DATETIME, 则返回 DATETIME 类型。
+- 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。
+
+特殊情况:
 - 若 `<seconds>` 为负数，函数效果等同于向基准时间中增加对应秒数（即 SECONDS_SUB(date, -n) 等价于 SECONDS_ADD(date, n)）。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00.
 - 若计算结果超出日期类型的有效范围,抛出异常。
@@ -83,6 +87,14 @@ SELECT SECONDS_SUB(NULL, 30), SECONDS_SUB('2025-01-23 12:34:56', NULL) AS result
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+-- TimeStampTz 类型示例, SET time_zone = '+08:00'
+SELECT SECONDS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| SECONDS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:22:32.123+08:00                   |
++-------------------------------------------------+
+
 
 --- 计算结果超出日期范围
 SELECT SECONDS_SUB('0000-01-01 00:00:00', 1) AS result;
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
index 4a0020f27927d..8237fa64ecf81 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
@@ -8,7 +8,7 @@
 
 ## 描述 
 
-WEEKS_ADD 函数用于在指定的日期或时间值上增加（或减少）指定数量的周数，等价于 在原有日期上 增加/减少 七天，返回调整后的日期或时间。
+WEEKS_ADD 函数用于在指定的日期或时间值上增加（或减少）指定数量的周数，等价于 在原有日期上 增加/减少 七天，返回调整后的日期或时间。该函数支持 DATE、DATETIME 和 TIMESTAMPTZ 输入类型。
 
 该函数与 [weeks_add 函数](./weeks-sub) 和 mysql 中的 [weeks_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_weeks-add) 使用 WEEK 为单位的行为一致。
 
@@ -20,17 +20,19 @@ WEEKS_ADD(`<datetime_or_date_expr>`, `<weeks_value>`)
 ## 参数
 | 参数                          | 描述                                                                               |
 |-------------------------------|-------------------------------------------------------------------------------------|
-| `<datetime_or_date_expr>` | 日期时间的输入值,，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
+| `<datetime_or_date_expr>` | 日期时间的输入值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
 | `<weeks_value>`            | INT 类型整数，表示要增加或减少的周数（正数表示增加，负数表示减少） |
 
 
 ## 返回值
 
+返回增加了指定周数的日期时间，返回值类型由第一个参数的类型决定：
 
-返回增加了指定周数的日期时间。
+- 若输入为 DATE 类型，返回值为 DATE 类型（仅调整年月日）。
+- 若输入为 DATETIME 类型，返回值为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+- 若输入为 TIMESTAMPTZ 类型，返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移量）。
 
-- 若输入为 DATE 类型，返回值仍为 DATE 类型（仅调整年月日）。
-- 若输入为 DATETIME 类型，返回值仍为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+特殊情况：
 - `<weeks_value>` 为负数时表示减少周数.
 - 任意输入参数为 NULL ，返回 NULL
 - 若计算结果超出日期类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误
@@ -77,6 +79,14 @@ SELECT WEEKS_ADD(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- TimestampTz 类型示例，SET time_zone = '+08:00'
+SELECT WEEKS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| WEEKS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-17 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 ---计算结果超出日期时间范围
 SELECT WEEKS_ADD('9999-12-31',1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation weeks_add of 9999-12-31, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
index f51b9eb2148f2..7f30ea199219a 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
@@ -7,7 +7,7 @@
 ---
 
 ## 描述
-WEEKS_SUB 函数用于在指定的日期或时间值上减少（或增加）指定数量的周数，返回调整后的日期或时间（本质是减去 weeks_value × 7 天）。支持处理 DATE、DATETIME 类型。
+WEEKS_SUB 函数用于在指定的日期或时间值上减少（或增加）指定数量的周数，返回调整后的日期或时间（本质是减去 weeks_value × 7 天）。支持处理 DATE、DATETIME 和 TIMESTAMPTZ 类型。
 
 该函数与 [weeks_sub 函数](./weeks-sub) 和 mysql 中的 [weeks_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_weeks-sub) 使用 WEEK 为单位的行为一致。
 
@@ -19,15 +19,18 @@ WEEKS_SUB(`<date_or_time_expr>`, `<week_period>`)
 ## 参数
 | 参数          | 描述                                                                |
 |---------------|-------------------------------------------------------------------|
-| `<date_or_time_expr>`  | 输入的日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                                       |
+| `<date_or_time_expr>`  | 输入的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                                       |
 | `week_period` | INT 类型整数，表示要减少的周数（正数表示减少，负数表示增加）。                                     |
 
 ## 返回值
-返回减少了指定周数的日期或时间：
+返回减少了指定周数的日期或时间，返回值类型由第一个参数的类型决定：
 
-- 若输入为 DATE 类型，返回值仍为 DATE 类型（仅调整年月日）。
-- 若输入为 DATETIME 类型，返回值仍为 DATETIME 类型（年月日调整后，时分秒保持不变）。
-- `<weeks_value>` 为负数时表示增加周数（等价于 WEEKS_ADD(`<datetime_or_date_value>`, `<weeks_value>`）。
+- 若输入为 DATE 类型，返回值为 DATE 类型（仅调整年月日）。
+- 若输入为 DATETIME 类型，返回值为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+- 若输入为 TIMESTAMPTZ 类型，返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移量）。
+
+特殊情况：
+- `<weeks_value>` 为负数时表示增加周数（等价于 WEEKS_ADD(`<datetime_or_date_value>`, `<weeks_value>`)）。
 - 任意输入参数为 NULL，返回 NULL。
 - 若计算结果超出日期类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
   
@@ -73,6 +76,14 @@ SELECT WEEKS_SUB(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- TimestampTz 类型示例，SET time_zone = '+08:00'
+SELECT WEEKS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| WEEKS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-03 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- 计算结果超出日期时间范围（下限）
 SELECT WEEKS_SUB('0000-01-01', 1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation weeks_add of 0000-01-01, -1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
index 0d5d0d6ab1160..064a36fc02d78 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-YEARS_ADD 函数用于在指定的日期或时间值上增加（或减少）指定数量的年数，返回调整后的日期或时间。支持处理 DATE、DATETIME 类型，年数可为正数（增加）或负数（减少）。
+YEARS_ADD 函数用于在指定的日期或时间值上增加（或减少）指定数量的年数,返回调整后的日期或时间。支持处理 DATE、DATETIME 类型,年数可为正数(增加)或负数(减少)。该函数支持 DATE、DATETIME 和 TIMESTAMPTZ 输入类型。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 中的 [date_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) 使用 YEAR 为单位的行为一致
 
@@ -22,16 +22,17 @@ YEARS_ADD(<date_or_time_expr>, <years>)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 输入的日期时间值，支持输入 date/datetime 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | 输入的日期时间值,支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion),[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<years>` | 要增加的年数，类型为 INT,负数表示减少，正数表示增加 |
 
 
 ## 返回值
 
-返回与输入类型一致的结果（DATE 或 DATETIME），表示调整后的日期或时间：
+返回与输入类型一致的结果（DATE 或 DATETIME 或 TIMESTAMPTZ）,表示调整后的日期或时间,返回值类型由第一个参数的类型决定:
 
-- 若输入为 DATE 类型，返回值仍为 DATE 类型（仅调整年月日）。
-- 若输入为 DATETIME 类型，返回值仍为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+- 若输入为 DATE 类型,返回值为 DATE 类型（仅调整年月日）。
+- 若输入为 DATETIME 类型,返回值为 DATETIME 类型（年月日调整后,时分秒保持不变）。
+- 若输入为 TIMESTAMPTZ 类型,返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移）。
 - <years_value> 为负数时表示减少年数（等价于 YEARS_SUB(<datetime_or_date_value>, <years_value>)）。
 - 任意输入参数为 NULL，返回 NULL。
 - 若计算结果超出日期类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
@@ -90,6 +91,14 @@ SELECT YEARS_ADD(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- TimestampTz 类型示例,SET time_zone = '+08:00'
+SELECT YEARS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| YEARS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2026-10-10 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- 计算结果超出日期时间范围（上限）
 SELECT YEARS_ADD('9999-12-31', 1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation years_add of 9999-12-31, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
index da721e63d13d3..2861ab4acd722 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-YEARS_SUB 函数用于在指定的日期或时间值上减少（或增加）指定数量的年数，返回调整后的日期或时间（本质是减去 years_value × 1 年）。支持处理 DATE、DATETIME 类型，年数可为正数（减少）或负数（增加）。
+YEARS_SUB 函数用于在指定的日期或时间值上减少（或增加）指定数量的年数,返回调整后的日期或时间（本质是减去 years_value × 1 年）。支持处理 DATE、DATETIME 类型,年数可为正数(减少)或负数(增加)。该函数支持 DATE、DATETIME 和 TIMESTAMPTZ 输入类型。
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 使用 YEAR 为单位的行为一致
 
@@ -22,15 +22,16 @@ YEARS_SUB(<date_or_time_expr>, <years>)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 输入的日期时间值，支持输入 date/datetime 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | 输入的日期时间值,支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion),[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<years>` | 要减少的年数，类型为 INT,整数表示减少，负数表示增加 |
 
 ## 返回值
 
-返回与输入类型一致的结果（DATE 或 DATETIME），表示调整后的日期或时间：
+返回与输入类型一致的结果（DATE 或 DATETIME 或 TIMESTAMPTZ）,表示调整后的日期或时间,返回值类型由第一个参数的类型决定:
 
-- 若输入为 DATE 类型，返回值仍为 DATE 类型（仅调整年月日）。
-- 若输入为 DATETIME 类型，返回值仍为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+- 若输入为 DATE 类型,返回值为 DATE 类型（仅调整年月日）。
+- 若输入为 DATETIME 类型,返回值为 DATETIME 类型（年月日调整后,时分秒保持不变）。
+- 若输入为 TIMESTAMPTZ 类型,返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移）。
 - <years_value> 为负数时表示增加年数（等价于 YEARS_ADD(<datetime_or_date_value>, <years_value>)）。
 - 任意输入参数为 NULL，返回 NULL。
 - 若计算结果超出日期类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
@@ -78,6 +79,14 @@ SELECT YEARS_SUB(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- TimestampTz 类型示例,SET time_zone = '+08:00'
+SELECT YEARS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| YEARS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2024-10-10 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- 计算结果超出日期时间范围（上限）
 SELECT YEARS_SUB('9999-12-31', -1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation year_add of 9999-12-31, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
index 9b820ee2119ee..519482cb11b45 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
@@ -10,7 +10,7 @@
 
 DATE_ADD 函数用于向指定的日期或时间值添加指定的时间间隔，并返回计算后的结果。
 
-- 支持的输入日期类型包括 DATE、DATETIME（如 '2023-12-31'、'2023-12-31 23:59:59'）。
+- 支持的输入日期类型包括 DATE、DATETIME、TIMESTAMPTZ（如 '2023-12-31'、'2023-12-31 23:59:59'、'2023-12-31 23:59:59+08:00'）。
 - 时间间隔由数值（`expre`）和单位（`time_unit`）共同指定，`expr` 为正数时表示“添加”，为负数时等效于“减去”对应间隔。
 
 ## 别名
@@ -28,7 +28,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 待处理的日期/时间值。支持类型：为 datetime 或者 date 类型，最高有六位秒数的精度（如 2022-12-28 23:59:59.999999），具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion))|
+| `<date_or_time_expr>` | 待处理的日期/时间值。支持类型：为 timestamptz, datetime 或者 date 类型，最高有六位秒数的精度（如 2022-12-28 23:59:59.999999），具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<expr>` | 希望添加的时间间隔，为 `INT` 类型|
 | `<time_unit>` | 枚举值：YEAR, QUARTER, MONTH, WEEK,DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR, MINUTE_SECOND, SECOND_MICROSECOND |
 
@@ -37,6 +37,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
 返回与 <date_or_time_expr> 类型一致的结果：
 - 输入 DATE 类型时，返回 DATE（仅日期部分）；
 - 输入 DATETIME 类型，返回 DATETIME（包含日期和时间）；
+- 输入 TIMESTAMPTZ 类型，返回 TIMESTAMPTZ(包含日期，时间和时区偏移量);
 - 带有 scale 的输入（如 '2024-01-01 12:00:00.123'）会保留 scale，最高六位小数精度。
 
 特殊情况：
@@ -126,7 +127,15 @@ mysql>  select date_add("2025-10-10 10:10:10.123456", INTERVAL "1.1" SECOND_MICR
 | date_add("2025-10-10 10:10:10.123456", INTERVAL "1.1" SECOND_MICROSECOND) |
 +---------------------------------------------------------------------------+
 | 2025-10-10 10:10:11.223456                                                |
-+---------------------------------------------------------------------------
++---------------------------------------------------------------------------+
+
+-- TimestampTz类型示例，SET time_zone = '+08:00'
+select DATE_ADD('2023-01-01 23:22:33+03:00', INTERVAL 1 DAY);
++-------------------------------------------------------+
+| DATE_ADD('2023-01-01 23:22:33+03:00', INTERVAL 1 DAY) |
++-------------------------------------------------------+
+| 2023-01-03 04:22:33+08:00                             |
++-------------------------------------------------------+
 
 ---非法单位
 select DATE_ADD('2023-12-31 23:00:00', INTERVAL 2 sa);
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
index 3797aa8328943..069fc1b88c283 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
@@ -2,13 +2,13 @@
 {
     "title": "DATE_SUB",
     "language": "zh-CN",
-    "description": "DATESUB 函数用于从指定的日期或时间值中减去指定的时间间隔，返回计算后的日期或时间结果。该函数支持对 DATE（仅日期）和 DATETIME（日期和时间）类型进行操作，时间间隔通过数值和单位共同定义。"
+    "description": "DATE_SUB 函数用于从指定的日期或时间值中减去指定的时间间隔，返回计算后的日期或时间结果。该函数支持对 DATE（仅日期）, DATETIME（日期和时间）TIMESTAMPTZ(带时区偏移量的日期时间)类型进行操作，时间间隔通过数值和单位共同定义。"
 }
 ---
 
 ## 描述
 
-DATE_SUB 函数用于从指定的日期或时间值中减去指定的时间间隔，返回计算后的日期或时间结果。该函数支持对 DATE（仅日期）和 DATETIME（日期和时间）类型进行操作，时间间隔通过数值和单位共同定义。
+DATE_SUB 函数用于从指定的日期或时间值中减去指定的时间间隔，返回计算后的日期或时间结果。该函数支持对 DATE（仅日期）, DATETIME（日期和时间）TIMESTAMPTZ(带时区偏移量的日期时间)类型进行操作，时间间隔通过数值和单位共同定义。
 
 该函数与 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 行为大致一致，但不同的是，mysql 支持联合单位的增减，如:
 
@@ -33,7 +33,7 @@ DATE_ADD(<date_or_time_part>, <expr> <time_unit>)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_part>` | 合法的日期值，支持为 datetime 或者 date 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)) |
+| `<date_or_time_part>` | 合法的日期值，支持为 timestamptz, datetime 或者 date 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<expr>` | 希望减去的时间间隔，类型为 `INT` |
 | `<time_unit>` | 枚举值：YEAR，QUARTER，MONTH，WEEK，DAY，HOUR，MINUTE，SECOND |
 
@@ -42,6 +42,7 @@ DATE_ADD(<date_or_time_part>, <expr> <time_unit>)
 返回与 date 类型一致的计算结果：
 - 输入 DATE 类型时，返回 DATE（仅日期部分）；
 - 输入 DATETIME 类型时，返回 DATETIME（包含日期和时间）。
+- 输入 TIMESTAMPTZ 类型时, 返回 TIMESTAMPTZ（包含日期，时间和时区偏移量）。
 - 对于带有 scale 的 datetime 类型，会保留 scale 返回。
 
 特殊情况：
@@ -109,7 +110,15 @@ mysql> select date_sub('2023-01-01', INTERVAL NULL DAY);
 | NULL                                      |
 +-------------------------------------------+
 
---非法单位，返回粗我
+-- TimeStampTz 类型测试，SET time_zone = '+08:00'
+SELECT DATE_SUB('2024-02-05 02:03:04.123+12:00', INTERVAL 1 DAY);
++-----------------------------------------------------------+
+| DATE_SUB('2024-02-05 02:03:04.123+12:00', INTERVAL 1 DAY) |
++-----------------------------------------------------------+
+| 2024-02-03 22:03:04.123+08:00                             |
++-----------------------------------------------------------+
+
+--非法单位，返回错误
 mysql> select date_sub('2022-01-01', INTERVAL 1 Y);
 ERROR 1105 (HY000): errCode = 2, detailMessage = 
 mismatched input 'Y' expecting {'.', '[', 'AND', 'BETWEEN', 'COLLATE', 'DAY', 'DIV', 'HOUR', 'IN', 'IS', 'LIKE', 'MATCH', 'MATCH_ALL', 'MATCH_ANY', 'MATCH_PHRASE', 'MATCH_PHRASE_EDGE', 'MATCH_PHRASE_PREFIX', 'MATCH_REGEXP', 'MINUTE', 'MONTH', 'NOT', 'OR', 'QUARTER', 'REGEXP', 'RLIKE', 'SECOND', 'WEEK', 'XOR', 'YEAR', EQ, '<=>', NEQ, '<', LTE, '>', GTE, '+', '-', '*', '/', '%', '&', '&&', '|', '||', '^'}(line 1, pos 41)
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
index a382c619f1dd5..db1ec22ec7de4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
@@ -2,13 +2,13 @@
 {
     "title": "HOURS_ADD",
     "language": "zh-CN",
-    "description": "HOURSADD 函数用于在输入的日期或日期时间值上增加或减少指定的小时数，并返回计算后的新日期时间。该函数支持 DATE 和 DATETIME 两种输入类型,若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型，再进行小时累加。"
+    "description": "HOURS_ADD 函数用于在输入的日期或日期时间值上增加或减少指定的小时数，并返回计算后的新日期时间。该函数支持 DATE, DATETIME 和 TIMESTAMPTZ 作为输入类型,若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型，再进行小时累加。"
 }
 ---
 
 ## 描述
 
-HOURS_ADD 函数用于在输入的日期或日期时间值上增加或减少指定的小时数，并返回计算后的新日期时间。该函数支持 DATE 和 DATETIME 两种输入类型,若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型，再进行小时累加。
+HOURS_ADD 函数用于在输入的日期或日期时间值上增加或减少指定的小时数，并返回计算后的新日期时间。该函数支持 DATE, DATETIME 和 TIMESTAMPTZ 作为输入类型,若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型，再进行小时累加。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 中的 [date_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) 使用 `HOUR` 单位的行为一致。
 
@@ -22,13 +22,16 @@ HOURS_ADD(`<date_or_time_expr>`, `<hours>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime 类型，具体 datetime,date格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<hours>` | 	要增加的小时数，类型为整数（INT），可正可负：正数：增加指定小时，负数：减少指定小时（等效于减去小时）。 |
 
 ## 返回值
 
-返回类型为 DATETIME，返回以输入日期时间为基准，增加或减小指定小时数后的时间值。
+返回基准时间`<date_or_time_expr>`加上指定小时`<hours>`的值，返回值类型由第一个参数类型决定:
+- 若第一个参数类型为 DATE/DATETIME, 则返回 DATETIME 类型。
+- 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。
 
+特殊情况:
 - 若计算结果超出 DATETIME 类型的有效范围 [0000-01-01 00:00:01,9999-12-31 23:59:59]，返回 错误。
 - 任意一个参数为 NULL， 返回 NULL
 
@@ -60,6 +63,13 @@ select hours_add('2023-10-01 10:00:00', -3) ;
 | 2023-10-01 07:00:00                  |
 +--------------------------------------+
 
+-- TimeStampTz 类型示例, SET time_zone = '+08:00'
++-----------------------------------------------+
+| HOURS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-10 13:22:33.123+08:00                 |
++-----------------------------------------------+
+
 ---输入参数为 NULL,返回 NULL
 select hours_add(null, 5) ;
 +--------------------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
index 6d5cb3ce95343..bd8b0ceb7ba5b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
@@ -2,13 +2,13 @@
 {
     "title": "HOURS_SUB",
     "language": "zh-CN",
-    "description": "HOURSSUB 函数用于从输入的日期或日期时间值中减去指定的小时数，并返回计算后的新日期时间。该函数支持 DATE 和 DATETIME 两种输入类型，若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型。"
+    "description": "HOURS_SUB 函数用于从输入的日期或日期时间值中减去指定的小时数，并返回计算后的新日期时间。该函数支持 DATE, DATETIME 和 TIMESTAMPTZ 作为输入类型，若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型。"
 }
 ---
 
 ## 描述
 
-HOURS_SUB 函数用于从输入的日期或日期时间值中减去指定的小时数，并返回计算后的新日期时间。该函数支持 DATE 和 DATETIME 两种输入类型，若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型。
+HOURS_SUB 函数用于从输入的日期或日期时间值中减去指定的小时数，并返回计算后的新日期时间。该函数支持 DATE, DATETIME 和 TIMESTAMPTZ 作为输入类型，若输入为 DATE 类型（仅包含年月日），会默认其时间部分为 00:00:00 转换为 DATETIME 类型。
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 使用 `HOUR` 单位的行为一致。
 
@@ -22,13 +22,16 @@ HOURS_SUB(`<date_or_time_expr>`, `<hours>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime 类型，具体 datetime,date格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<hours>` | 要减去的小时数，类型为 INT |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示加上或减去指定小时后的日期时间（格式为 YYYY-MM-DD HH:MM:SS）
+返回基准时间`<date_or_time_expr>`减去指定小时`<hours>`的值，返回值类型由第一个参数类型决定:
+- 若第一个参数类型为 DATE/DATETIME, 则返回 DATETIME 类型。
+- 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。
 
+特殊情况:
 - 若计算结果超出 DATETIME 类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
 - 输入任一参数为 NULL，返回 NULL
 - 输入 hours 为负数，返回日期时间加上对应小时数
@@ -61,6 +64,14 @@ select hours_sub('2023-10-01 10:00:00', -3);
 | 2023-10-01 13:00:00                  |
 +--------------------------------------+
 
+-- TimeStampTz 类型示例, SET time_zone = '+08:00'
+SELECT HOURS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| HOURS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-10 11:22:33.123+08:00                 |
++-----------------------------------------------+
+
 ---任意参数为 NULL ,返回 NULL
 select hours_sub('2023-10-01 10:00:00', NULL);
 +----------------------------------------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
index 74e02a31a3262..6a78b1fd1d6b6 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
@@ -2,13 +2,13 @@
 {
     "title": "MICROSECONDS_ADD",
     "language": "zh-CN",
-    "description": "MICROSECONDSADD 函数用于向输入的日期时间值中添加指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 类型。"
+    "description": "MICROSECONDS_ADD 函数用于向输入的日期时间值中添加指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 或 TIMESTAMPTZ 类型。"
 }
 ---
 
 ## 描述
 
-MICROSECONDS_ADD 函数用于向输入的日期时间值中添加指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 类型。
+MICROSECONDS_ADD 函数用于向输入的日期时间值中添加指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 或 TIMESTAMPTZ 类型。
 
 
 该函数与 mysql 中的 [date_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) 使用 MICROSECOND 为单位的行为一致。
@@ -16,19 +16,21 @@ MICROSECONDS_ADD 函数用于向输入的日期时间值中添加指定的微秒
 ## 语法
 
 ```sql
-MICROSECONDS_ADD(`<datetime>`, `<delta>`)
+MICROSECONDS_ADD(`<datetime_like_type>`, `<delta>`)
 ```
 
 ## 参数
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<datetime>` | 输入的日期时间值，类型为 DATETIME，具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)  |
+| `<datetime_like_type>` | 输入的日期时间值，类型为 DATETIME 或 TIMESTAMPTZ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)  |
 | `<delta>` | 要添加的微秒数，类型为 BIGINT，1 秒 = 1,000,000 微秒 |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示基准时间添加指定微秒后的结果（格式为 YYYY-MM-DD HH:MM:SS.ffffff，其中小数部分精度与 datetime 一致）。
+返回基准时间`<datetime_like_type>`添加指定微秒`<delta>`后的结果，返回类型与第一个参数类型相同
+- 若第一个参数为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ。
+- 若第一个参数为 DATETIME, 则返回 DATETIME。
 
 - 若 `<delta>` 为负数，函数效果等同于从基准时间中减去对应微秒数（即 MICROSECONDS_ADD(basetime, -n) 等价于 MICROSECONDS_SUB(basetime, n)）。
 - 若计算结果超出 DATETIME 类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999），抛出异常。
@@ -62,6 +64,14 @@ SELECT MICROSECONDS_ADD('2023-10-01', -300000);
 | 2023-09-30 23:59:59.700000              |
 +-----------------------------------------+
 
+-- TimeStampTz 类型测试, SET time_zone = '+08:00'
+SELECT MICROSECONDS_ADD('2024-12-25 12:34:56.123+04:00', '765800');
++-------------------------------------------------------------+
+| MICROSECONDS_ADD('2024-12-25 12:34:56.123+04:00', '765800') |
++-------------------------------------------------------------+
+| 2024-12-25 16:34:56.888800+08:00                            |
++-------------------------------------------------------------+
+
 ---计算结果超过日期时间范围，报错
 SELECT MICROSECONDS_ADD('9999-12-31 23:59:59.999999', 2000000) AS after_add;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 9999-12-31 23:59:59.999999, 2000000 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
index 1b82856622d65..38602dc69b0dc 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
@@ -2,32 +2,32 @@
 {
     "title": "MICROSECONDS_SUB",
     "language": "zh-CN",
-    "description": "MICROSECONDSSUB 函数用于从输入的日期时间值中减去指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 类型。"
+    "description": "MICROSECONDSSUB 函数用于从输入的日期时间值中减去指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 和 TIMESTAMPTZ 类型。"
 }
 ---
 
 ## 描述
 
-MICROSECONDS_SUB 函数用于从输入的日期时间值中减去指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 类型。
+MICROSECONDS_SUB 函数用于从输入的日期时间值中减去指定的微秒数，并返回计算后的新日期时间值。该函数支持处理含微秒精度的 DATETIME 和TIMESTAMPTZ 类型。
 
 该函数与 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 使用 MICROSECOND 为单位的行为一致。
 
 ## 语法
 
 ```sql
-MICROSECONDS_SUB(`<datetime>`, `<delta>`)
+MICROSECONDS_SUB(`<datetime_like_type>`, `<delta>`)
 ```
 
 ## 参数
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<datetime>` | 输入的日期时间值，类型为 DATETIME，具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
+| `<datetime_like_type>` | 输入的日期时间值，类型为 DATETIME 或 TIMESTAMPTZ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
 | `<delta>` | 要减去的微秒数，类型为 BIGINT，1 秒 = 1,000,000 微秒 |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示基准时间减去指定微秒后的结果。
+返回基准时间`<datetime_like_type>`减去指定微秒`<delta>`后的结果，返回类型与第一个参数类型相同
 
 - 若 `<delta>` 为负数，函数效果等同于向基准时间中添加对应微秒数（即 MICROSECONDS_SUB(basetime, -n) 等价于 MICROSECONDS_ADD(basetime, n)）。
 - 若计算结果超出 DATETIME 类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999），抛出异常。
@@ -69,6 +69,14 @@ SELECT MICROSECONDS_SUB('2023-10-01', -300000);
 | 2023-10-01 00:00:00.300000              |
 +-----------------------------------------+
 
+-- TimeStampTz 类型测试, SET time_zone = '+08:00'
+SELECT MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800');
++-------------------------------------------------------------+
+| MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800') |
++-------------------------------------------------------------+
+| 2024-12-25 16:34:55.357200+08:00                            |
++-------------------------------------------------------------+
+
 ---超出日期时间范围，抛出错误
 mysql> SELECT MICROSECONDS_SUB('0000-01-01 00:00:00.000000', 1000000) AS after_sub;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 0000-01-01 00:00:00, -1000000 
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
index d7cdc7d4b5536..49c799c28d450 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
@@ -2,13 +2,13 @@
 {
     "title": "MINUTES_ADD",
     "language": "zh-CN",
-    "description": "MINUTESADD 函数用于向输入的日期时间值中添加指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型。"
+    "description": "MINUTESADD 函数用于向输入的日期时间值中添加指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ类型。"
 }
 ---
 
 ## 描述
 
-MINUTES_ADD 函数用于向输入的日期时间值中添加指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型。
+MINUTES_ADD 函数用于向输入的日期时间值中添加指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ类型。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 的 [date-add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) 使用 MINUTE 为单位的行为一致。
 
@@ -22,13 +22,16 @@ MINUTES_ADD(`<date_or_time_expr>`, `<minutes>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| ``<date_or_time_expr>`` | 输入的日期时间值，类型可以是 DATE、DATETIME ，具体 datetime/date 请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion), |
+| ``<date_or_time_expr>`` | 输入的日期时间值，类型可以是 DATE、DATETIME、TIMESTAMPTZ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion), |
 | ``<minutes>`` | 要增加的分钟数，类型为 BIGINT，可以为正数或负数 |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示基准时间添加指定分钟后的结果。
+返回基准时间`<datetime_like_type>`添加指定分钟`<minutes>`后的结果，返回类型与第一个参数类型相关:
+- 若第一个参数为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ。
+- 若第一个参数为 DATETIME, 则返回 DATETIME。
 
+特殊情况:
 - 若 `<minutes>` 为负数，函数效果等同于从基准时间中减去对应分钟数（即 MINUTES_ADD(date, -n) 等价于 MINUTES_SUB(date, n)）。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00。
 - 若输入的日期时间包含微秒部分，添加分钟后会保留原微秒精度（如 '2023-01-01 00:00:00.123456' 添加 1 分钟后为 '2023-01-01 00:01:00.123456'）。
@@ -70,6 +73,14 @@ SELECT MINUTES_ADD('2023-07-13 22:28:18', -5) AS result;
 | 2023-07-13 22:23:18 |
 +---------------------+
 
+-- TimeStampTz 类型测试, SET time_zone = '+08:00'
+SELECT MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:23:33.123+08:00                   |
++-------------------------------------------------+
+
 --- 任一参数为 NULL，返回 NULL
 SELECT MINUTES_ADD(NULL, 10), MINUTES_ADD('2023-07-13 22:28:18', NULL) AS result;
 +-------------------------+--------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
index 9ba1b8d20e237..903eb4f537a93 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
@@ -2,13 +2,13 @@
 {
     "title": "MINUTES_SUB",
     "language": "zh-CN",
-    "description": "MINUTESSUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型."
+    "description": "MINUTESSUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ类型."
 }
 ---
 
 ## 描述
 
-MINUTES_SUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型.
+MINUTES_SUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ类型.
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 的 [date-add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) 使用 MINUTE 为单位的行为一致。
 
@@ -22,14 +22,17 @@ MINUTES_SUB(`<date_or_time_expr>`, `<minutes>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| ``<date_or_time_expr>`` | 输入的日期时间值，类型可以是 DATE、DATETIME ，具体 datetime/date 请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| ``<date_or_time_expr>`` | 输入的日期时间值，类型可以是 DATE、DATETIME、TIMESTAMPTZ ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | ``<minutes>`` | 要减去的分钟数，类型为 BIGINT，可以为正数或负数 |
 
 ## 返回值
 
 
-返回类型为 DATETIME，表示减去指定分钟数后的日期时间值。
+返回基准时间`<datetime_like_type>`减去指定分钟`<minutes>`后的结果，返回类型与第一个参数类型相关:
+- 若第一个参数为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ。
+- 若第一个参数为 DATETIME, 则返回 DATETIME。
 
+特殊情况:
 - 若 `<minutes>` 为负数，函数效果等同于向基准时间中添加对应分钟数（即 MINUTES_SUB(date, -n) 等价于 MINUTES_ADD(date, n)）。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00。
 - 若输入的日期时间包含微秒部分，减去分钟后会保留原微秒精度（如 '2023-01-01 00:01:00.123456' 减去 1 分钟后为 '2023-01-01 00:00:00.123456'）。
@@ -73,6 +76,14 @@ SELECT MINUTES_SUB('2023-07-13', 30) AS result;
 | 2023-07-12 23:30:00 |
 +---------------------+
 
+-- TimeStampTz 类型测试, SET time_zone = '+08:00'
+SELECT MINUTES_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| MINUTES_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:21:33.123+08:00                   |
++-------------------------------------------------+
+
 --- 任一参数为 NULL，返回 NULL
 SELECT MINUTES_SUB(NULL, 10), MINUTES_SUB('2023-07-13 22:28:18', NULL) AS result;
 +-----------------------+--------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
index 5469a353e7095..1dda7db6c360e 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-MONTHS_ADD 函数用于向输入的日期时间值中添加指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于减去对应月份数。
+MONTHS_ADD 函数用于向输入的日期时间值中添加指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME 和 TIMESTAMPTZ 类型，若输入负数则等效于减去对应月份数。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 的 [date-add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) 使用 MONTH 为单位的行为一致。
 
@@ -22,14 +22,13 @@ MONTHS_ADD(`<date_or_time_expr>`, `<nums>`)
 
 | 参数                | 说明            |
 |-------------------|---------------|
-| ``<date_or_time_expr>`` | 输入的日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
+| ``<date_or_time_expr>`` | 输入的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
 | ``<nums>``          | 需要加减的月份数 ,为 INT 类型，负数表示日期时间减去 nums 月份，正数表示加上 nums 月份   |
 
 ## 返回值
-返回与输入 `<date_or_time_expr>` 同类型的值（DATE 或 DATETIME），表示基准时间添加指定月份后的结果。
+返回与输入 `<date_or_time_expr>` 同类型的值(DATE, DATETIME 或 TIMESTAMPTZ)，表示基准时间添加指定月份后的结果。
 
 - 若 `<months>` 为负数，函数效果等同于从基准时间中减去对应月份数（即 MONTHS_ADD (date, -n) 等价于 MONTHS_SUB (date, n)）。
-- 若输入为 DATE 类型（仅包含年月日），返回结果仍为 DATE 类型；若输入为 DATETIME 类型，返回结果保留原时间部分（如 '2023-01-01 12:34:56' 添加 1 个月后为 '2023-02-01 12:34:56'）。
 - 若输入日期为当月最后一天，且目标月份天数少于该日期，则自动调整为目标月份的最后一天（如 1 月 31 日加 1 个月为 2 月 28 日或 29 日，具体取决于是否为闰年）。
 - 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
 - 若任一参数为 NULL，返回 NULL。
@@ -86,6 +85,14 @@ SELECT MONTHS_ADD(NULL, 5), MONTHS_ADD('2023-07-13', NULL) AS result;
 | NULL                 | NULL   |
 +----------------------+--------+
 
+--- TimestampTz 类型示例，SET time_zone = '+08:00'
+SELECT MONTHS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++------------------------------------------------+
+| MONTHS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++------------------------------------------------+
+| 2025-11-10 12:22:33.123+08:00                  |
++------------------------------------------------+
+
 --- 计算结果超出日期范围
 mysql> SELECT MONTHS_ADD('9999-12-31', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation months_add of 9999-12-31, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
index ef98c11d4ef9d..4c9308e5889df 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-MONTHS_SUB 函数用于从输入的日期时间值中减去指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于添加对应月份数。
+MONTHS_SUB 函数用于从输入的日期时间值中减去指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME 和 TIMESTAMPTZ 类型，若输入负数则等效于添加对应月份数。
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 的 [date-sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_sub) 使用 MONTH 为单位的行为一致。
 
@@ -22,15 +22,14 @@ MONTHS_SUB(`<date_or_time_expr>`  `<nums>`)
 
 | 参数                | 说明            |
 |-------------------|---------------|
-| ``<date_or_time_expr>`` | 需要被计算加减月份的日期值,支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| ``<date_or_time_expr>`` | 需要被计算加减月份的日期值,支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | ``<nums>``          |需要减去的月份数，为 INT 类型，正数表示日期时间减去 nums 月份，负数表示加上 nums 月份 |
 
 ## 返回值
 
-返回与输入 `<date_or_time_expr>` 同类型的值（DATE 或 DATETIME），表示基准时间减去指定月份后的结果。
+返回与输入 `<date_or_time_expr>` 同类型的值(DATE, DATETIME 或 TIMESTAMPTZ)，表示基准时间减去指定月份后的结果。
 
 - 若 `<nums>` 为负数，函数效果等同于向基准时间中添加对应月份数（即 MONTHS_SUB (date, -n) 等价于 MONTHS_ADD (date, n)）。
-- 若输入为 DATE 类型（仅包含年月日），返回结果仍为 DATE 类型；若输入为 DATETIME 类型，返回结果保留原时间部分（如 '2023-03-01 12:34:56' 减去 1 个月后为 '2023-02-01 12:34:56'）。
 - 若输入日期为当月最后一天，且目标月份天数少于该日期，则自动调整为目标月份的最后一天（如 3 月 31 日减 1 个月为 2 月 28 日或 29 日，具体取决于是否为闰年）。
 - 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
 - 若任一参数为 NULL，返回 NULL。
@@ -87,6 +86,14 @@ SELECT MONTHS_SUB(NULL, 5), MONTHS_SUB('2023-07-13', NULL) AS result;
 | NULL                 | NULL   |
 +----------------------+--------+
 
+--- TimestampTz 类型示例，SET time_zone = '+08:00'
+SELECT MONTHS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++------------------------------------------------+
+| MONTHS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++------------------------------------------------+
+| 2025-09-10 12:22:33.123+08:00                  |
++------------------------------------------------+
+
 --- 计算结果超出日期范围
 mysql> SELECT MONTHS_SUB('0000-01-01', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation months_add of 0000-01-01, -1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
index aa11685d64011..f1fe767d00873 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
@@ -7,7 +7,7 @@
 ---
 
 ## 描述
-QUARTERS_ADD 函数用于在指定的日期时间值基础上增加或减少指定的季度数（1 个季度 = 3 个月），并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于减去对应季度数。
+QUARTERS_ADD 函数用于在指定的日期时间值基础上增加或减少指定的季度数（1 个季度 = 3 个月）,并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型,若输入负数则等效于减去对应季度数。该函数支持 DATE、DATETIME 和 TIMESTAMPTZ 输入类型。
 
 该函数与 [date_add 函数](./date-add) 使用 QUARTER 为单位行为一致。
 
@@ -21,13 +21,14 @@ QUARTERS_ADD(`<date_or_time_expr>`, `<quarters>`)
 
 | 参数                | 说明                                 |
 |-------------------|------------------------------------|
-| ``<date_or_time_expr>`` | 输入的日期或日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)。 |
+| ``<date_or_time_expr>`` | 输入的日期或日期时间值,支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion),[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)。 |
 | ``<quarters>``      | 要增加或减少的季度数，正整数表示增加，负整数表示减少。        |
 
 ## 返回值
-返回一个日期值，与输入的日期类型一致。
-- 若 `<quarters>` 为负数，函数效果等同于从基准时间中减去对应季度数（即 QUARTERS_ADD(date, -n) 等价于 QUARTERS_SUB(date, n)）。
-- 若输入为 DATE 类型（仅包含年月日），返回结果仍为 DATE 类型；若输入为 DATETIME 类型，返回结果保留原时间部分（如 '2023-01-01 12:34:56' 加 1 个季度后为 '2023-04-01 12:34:56'）。
+返回一个日期值,与输入的日期类型一致,返回值类型由第一个参数的类型决定:
+- 若 `<quarters>` 为负数,函数效果等同于从基准时间中减去对应季度数（即 QUARTERS_ADD(date, -n) 等价于 QUARTERS_SUB(date, n)）。
+- 若输入为 DATE 类型（仅包含年月日）,返回结果为 DATE 类型；若输入为 DATETIME 类型,返回结果为 DATETIME 类型保留原时间部分（如 '2023-01-01 12:34:56' 加 1 个季度后为 '2023-04-01 12:34:56'）。
+- 若输入为 TIMESTAMPTZ 类型,返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移）。
 - 若输入日期为当月最后一天，且目标月份天数少于该日期，则自动调整为目标月份的最后一天（如 1 月 31 日加 1 个季度（3 个月）为 4 月 30 日）。
 - 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59），抛出异常。
 - 若任一参数为 NULL，返回 NULL。
@@ -91,6 +92,14 @@ SELECT QUARTERS_ADD(NULL, 1), QUARTERS_ADD('2023-07-13', NULL) AS result;
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+--- TimestampTz 类型示例,SET time_zone = '+08:00'
+SELECT QUARTERS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++--------------------------------------------------+
+| QUARTERS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++--------------------------------------------------+
+| 2026-01-10 12:22:33.123+08:00                    |
++--------------------------------------------------+
+
 --- 计算结果超出日期范围
 SELECT QUARTERS_ADD('9999-10-31', 2) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation month_add of 9999-10-31, 6 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
index 9d9dec2be97b5..a8d082c0afbc6 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
@@ -9,7 +9,7 @@
 ## 描述
 
 
-QUARTERS_SUB 函数用于在指定的日期时间值基础上减去或增加指定的季度数（1 个季度 = 3 个月），并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于增加对应季度数。
+QUARTERS_SUB 函数用于在指定的日期时间值基础上减去或增加指定的季度数（1 个季度 = 3 个月），并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 和 TIMESTAMPTZ 类型，若输入负数则等效于增加对应季度数。
 
 该函数与 [date_sub 函数](./date-sub) 使用 QUARTER 为单位行为一致。
 
@@ -23,14 +23,15 @@ QUARTERS_SUB(`<date_or_time_expr>`, `<quarters>`)
 
 | 参数                | 说明                                 |
 |-------------------|------------------------------------|
-| `<date_or_time_expr` | 输入的日期或日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)。 |
+| `<date_or_time_expr>` | 输入的日期或日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)。 |
 | ``<quarters>``      | 要增加或减少的季度数，正整数表示增加，负整数表示减少。        |
 
 ## 返回值
-返回一个日期值，与输入的日期类型一致。
+返回一个日期值，与输入的日期类型一致，返回值类型由第一个参数的类型决定：
 
 - 若 `<quarters>` 为负数，函数效果等同于向基准时间中增加对应季度数（即 QUARTERS_SUB (date, -n) 等价于 QUARTERS_ADD (date, n)）。
-- 若输入为 DATE 类型（仅包含年月日），返回结果仍为 DATE 类型；若输入为 DATETIME 类型，返回结果保留原时间部分（如 '2023-04-01 12:34:56' 减 1 个季度后为 '2023-01-01 12:34:56'）。
+- 若输入为 DATE 类型（仅包含年月日），返回结果为 DATE 类型；若输入为 DATETIME 类型，返回结果保留原时间部分（如 '2023-04-01 12:34:56' 减 1 个季度后为 '2023-01-01 12:34:56'）。
+- 若输入为 TIMESTAMPTZ 类型，返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移）。
 - 若输入日期为当月最后一天，且目标月份天数少于该日期，则自动调整为目标月份的最后一天（如 4 月 30 日减 1 个季度（3 个月）为 1 月 31 日）。
 - 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59），抛出异常。
 - 若任一参数为 NULL，返回 NULL。
@@ -94,6 +95,14 @@ SELECT QUARTERS_SUB(NULL, 1), QUARTERS_SUB('2023-07-13', NULL) AS result;
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+--- TimestampTz 类型示例,SET time_zone = '+08:00'
+SELECT QUARTERS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++--------------------------------------------------+
+| QUARTERS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++--------------------------------------------------+
+| 2025-07-10 12:22:33.123+08:00                    |
++--------------------------------------------------+
+
 --- 计算结果超出日期范围
 SELECT QUARTERS_SUB('0000-04-30', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation quarters_sub of 0000-04-30, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
index d942aabf04127..085279e6e7e38 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
@@ -2,12 +2,12 @@
 {
     "title": "SECONDS_ADD",
     "language": "zh-CN",
-    "description": "SECONDSADD 函数用于在指定的日期时间值上增加或减少指定的秒数，并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于减去对应秒数。"
+    "description": "SECONDSADD 函数用于在指定的日期时间值上增加或减少指定的秒数，并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ 类型，若输入负数则等效于减去对应秒数。"
 }
 ---
 
 ## 描述
-SECONDS_ADD 函数用于在指定的日期时间值上增加或减少指定的秒数，并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于减去对应秒数。
+SECONDS_ADD 函数用于在指定的日期时间值上增加或减少指定的秒数，并并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ 类型，若输入负数则等效于减去对应秒数。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 中的 [date_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) 使用 SECOND 为单位的行为一致
 
@@ -20,16 +20,19 @@ SECONDS_ADD(<date_or_time_expr>, <seconds>)
 
 | 参数           | 说明                                          |
 |--------------|---------------------------------------------|
-| `<date_or_time_expr>` | 必填，输入的日期时间值，类型可以是 DATE、DATETIME ，具体 datetime/date 请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)           |
+| `<date_or_time_expr>` | 必填，输入的日期时间值，类型可以是 DATE、DATETIME、TIMESTAMPTZ ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)           |
 | `<seconds>`  | 必填，要增加或减少的秒数，支持整数类型（BIGINT）。正数表示增加秒数，负数表示减少秒数。 |
 
 ## 返回值
 
-返回一个日期时间值，类型与输入的 <date_or_time_expr> 类型一致。
+返回基准时间`<date_or_time_expr>`添加指定秒数`<second>`的值，返回值类型由第一个参数类型决定:
+- 若第一个参数类型为 DATE/DATETIME, 则返回 DATETIME 类型。
+- 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。
 
+特殊情况：
 - 若 <seconds> 为负数，函数效果等同于从基准时间中减去对应秒数（即 SECONDS_ADD(date, -n) 等价于 SECONDS_SUB(date, n)）。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00/
-- 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999），返回错误。
+- 若计算结果超出日期类型的有效范围（DATE 类型：0000-01-01 至 9999-12-31；DATETIME/TIMESTAMPTZ 类型：0000-01-01 00:00:00 至 9999-12-31 23:59:59.999999），返回错误。
 - 若任一参数为 NULL，返回 NULL。
 
 
@@ -75,6 +78,14 @@ SELECT SECONDS_ADD('2023-07-13 10:30:25.123456', 2) AS result;
 | 2023-07-13 10:30:27.123456 |
 +----------------------------+
 
+-- TimeStampTz 类型示例, SET time_zone = '+08:00'
+SELECT SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:22:34.123+08:00                   |
++-------------------------------------------------+
+
 --- 输入为 NULL 时返回 NULL
 SELECT SECONDS_ADD(NULL, 30), SECONDS_ADD('2025-01-23 12:34:56', NULL) AS result;
 +-------------------------+--------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
index b77d8bc0b63a9..d93535d51baf7 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
@@ -2,12 +2,12 @@
 {
     "title": "SECONDS_SUB",
     "language": "zh-CN",
-    "description": "SECONDSSUB 函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于增加对应秒数。"
+    "description": "SECONDSSUB 函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ 类型，若输入负数则等效于增加对应秒数。"
 }
 ---
 
 ## 描述
-SECONDS_SUB 函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME 类型，若输入负数则等效于增加对应秒数。
+SECONDS_SUB 函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值。该函数支持处理 DATE、DATETIME、TIMESTAMPTZ 类型，若输入负数则等效于增加对应秒数。
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 使用 SECOND 为单位的行为一致
 
@@ -20,12 +20,16 @@ SECONDS_SUB(<date_or_time_expr>, <seconds>)
 
 | 参数           | 说明                                          |
 |--------------|---------------------------------------------|
-| `<date_or_time_expr>` | 必填，输入的日期时间值，类型可以是 DATE、DATETIME ，具体 datetime/date 请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)        |
+| `<date_or_time_expr>` | 必填，输入的日期时间值，类型可以是 DATE、DATETIME、TIMESTAMPTZ ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)        |
 | `<seconds>`  | 必填，要减少或增加的秒数，支持整数类型（BIGINT）。正数表示增加秒数，负数表示减少秒数。 |
 
 ## 返回值
 
-返回一个输入日期时间增加对应秒数后的日期时间值，类型为 DATETIME
+返回基准时间`<date_or_time_expr>`减去指定秒数`<second>`的值，返回值类型由第一个参数类型决定:
+- 若第一个参数类型为 DATE/DATETIME, 则返回 DATETIME 类型。
+- 若第一个参数类型为 TIMESTAMPTZ, 则返回 TIMESTAMPTZ 类型。
+
+特殊情况:
 - 若 `<seconds>` 为负数，函数效果等同于向基准时间中增加对应秒数（即 SECONDS_SUB(date, -n) 等价于 SECONDS_ADD(date, n)）。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00.
 - 若计算结果超出日期类型的有效范围,抛出异常。
@@ -83,6 +87,14 @@ SELECT SECONDS_SUB(NULL, 30), SECONDS_SUB('2025-01-23 12:34:56', NULL) AS result
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+-- TimeStampTz 类型示例, SET time_zone = '+08:00'
+SELECT SECONDS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| SECONDS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:22:32.123+08:00                   |
++-------------------------------------------------+
+
 
 --- 计算结果超出日期范围
 SELECT SECONDS_SUB('0000-01-01 00:00:00', 1) AS result;
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
index 4a0020f27927d..8237fa64ecf81 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
@@ -8,7 +8,7 @@
 
 ## 描述 
 
-WEEKS_ADD 函数用于在指定的日期或时间值上增加（或减少）指定数量的周数，等价于 在原有日期上 增加/减少 七天，返回调整后的日期或时间。
+WEEKS_ADD 函数用于在指定的日期或时间值上增加（或减少）指定数量的周数，等价于 在原有日期上 增加/减少 七天，返回调整后的日期或时间。该函数支持 DATE、DATETIME 和 TIMESTAMPTZ 输入类型。
 
 该函数与 [weeks_add 函数](./weeks-sub) 和 mysql 中的 [weeks_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_weeks-add) 使用 WEEK 为单位的行为一致。
 
@@ -20,17 +20,19 @@ WEEKS_ADD(`<datetime_or_date_expr>`, `<weeks_value>`)
 ## 参数
 | 参数                          | 描述                                                                               |
 |-------------------------------|-------------------------------------------------------------------------------------|
-| `<datetime_or_date_expr>` | 日期时间的输入值,，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
+| `<datetime_or_date_expr>` | 日期时间的输入值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
 | `<weeks_value>`            | INT 类型整数，表示要增加或减少的周数（正数表示增加，负数表示减少） |
 
 
 ## 返回值
 
+返回增加了指定周数的日期时间，返回值类型由第一个参数的类型决定：
 
-返回增加了指定周数的日期时间。
+- 若输入为 DATE 类型，返回值为 DATE 类型（仅调整年月日）。
+- 若输入为 DATETIME 类型，返回值为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+- 若输入为 TIMESTAMPTZ 类型，返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移量）。
 
-- 若输入为 DATE 类型，返回值仍为 DATE 类型（仅调整年月日）。
-- 若输入为 DATETIME 类型，返回值仍为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+特殊情况：
 - `<weeks_value>` 为负数时表示减少周数.
 - 任意输入参数为 NULL ，返回 NULL
 - 若计算结果超出日期类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误
@@ -77,6 +79,14 @@ SELECT WEEKS_ADD(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- TimestampTz 类型示例，SET time_zone = '+08:00'
+SELECT WEEKS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| WEEKS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-17 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 ---计算结果超出日期时间范围
 SELECT WEEKS_ADD('9999-12-31',1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation weeks_add of 9999-12-31, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
index f51b9eb2148f2..7f30ea199219a 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
@@ -7,7 +7,7 @@
 ---
 
 ## 描述
-WEEKS_SUB 函数用于在指定的日期或时间值上减少（或增加）指定数量的周数，返回调整后的日期或时间（本质是减去 weeks_value × 7 天）。支持处理 DATE、DATETIME 类型。
+WEEKS_SUB 函数用于在指定的日期或时间值上减少（或增加）指定数量的周数，返回调整后的日期或时间（本质是减去 weeks_value × 7 天）。支持处理 DATE、DATETIME 和 TIMESTAMPTZ 类型。
 
 该函数与 [weeks_sub 函数](./weeks-sub) 和 mysql 中的 [weeks_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_weeks-sub) 使用 WEEK 为单位的行为一致。
 
@@ -19,15 +19,18 @@ WEEKS_SUB(`<date_or_time_expr>`, `<week_period>`)
 ## 参数
 | 参数          | 描述                                                                |
 |---------------|-------------------------------------------------------------------|
-| `<date_or_time_expr>`  | 输入的日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                                       |
+| `<date_or_time_expr>`  | 输入的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion)，[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                                       |
 | `week_period` | INT 类型整数，表示要减少的周数（正数表示减少，负数表示增加）。                                     |
 
 ## 返回值
-返回减少了指定周数的日期或时间：
+返回减少了指定周数的日期或时间，返回值类型由第一个参数的类型决定：
 
-- 若输入为 DATE 类型，返回值仍为 DATE 类型（仅调整年月日）。
-- 若输入为 DATETIME 类型，返回值仍为 DATETIME 类型（年月日调整后，时分秒保持不变）。
-- `<weeks_value>` 为负数时表示增加周数（等价于 WEEKS_ADD(`<datetime_or_date_value>`, `<weeks_value>`）。
+- 若输入为 DATE 类型，返回值为 DATE 类型（仅调整年月日）。
+- 若输入为 DATETIME 类型，返回值为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+- 若输入为 TIMESTAMPTZ 类型，返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移量）。
+
+特殊情况：
+- `<weeks_value>` 为负数时表示增加周数（等价于 WEEKS_ADD(`<datetime_or_date_value>`, `<weeks_value>`)）。
 - 任意输入参数为 NULL，返回 NULL。
 - 若计算结果超出日期类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
   
@@ -73,6 +76,14 @@ SELECT WEEKS_SUB(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- TimestampTz 类型示例，SET time_zone = '+08:00'
+SELECT WEEKS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| WEEKS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-03 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- 计算结果超出日期时间范围（下限）
 SELECT WEEKS_SUB('0000-01-01', 1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation weeks_add of 0000-01-01, -1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
index 0d5d0d6ab1160..064a36fc02d78 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-YEARS_ADD 函数用于在指定的日期或时间值上增加（或减少）指定数量的年数，返回调整后的日期或时间。支持处理 DATE、DATETIME 类型，年数可为正数（增加）或负数（减少）。
+YEARS_ADD 函数用于在指定的日期或时间值上增加（或减少）指定数量的年数,返回调整后的日期或时间。支持处理 DATE、DATETIME 类型,年数可为正数(增加)或负数(减少)。该函数支持 DATE、DATETIME 和 TIMESTAMPTZ 输入类型。
 
 该函数与 [date_add 函数](./date-add) 和 mysql 中的 [date_add 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) 使用 YEAR 为单位的行为一致
 
@@ -22,16 +22,17 @@ YEARS_ADD(<date_or_time_expr>, <years>)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 输入的日期时间值，支持输入 date/datetime 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | 输入的日期时间值,支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion),[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<years>` | 要增加的年数，类型为 INT,负数表示减少，正数表示增加 |
 
 
 ## 返回值
 
-返回与输入类型一致的结果（DATE 或 DATETIME），表示调整后的日期或时间：
+返回与输入类型一致的结果（DATE 或 DATETIME 或 TIMESTAMPTZ）,表示调整后的日期或时间,返回值类型由第一个参数的类型决定:
 
-- 若输入为 DATE 类型，返回值仍为 DATE 类型（仅调整年月日）。
-- 若输入为 DATETIME 类型，返回值仍为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+- 若输入为 DATE 类型,返回值为 DATE 类型（仅调整年月日）。
+- 若输入为 DATETIME 类型,返回值为 DATETIME 类型（年月日调整后,时分秒保持不变）。
+- 若输入为 TIMESTAMPTZ 类型,返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移）。
 - <years_value> 为负数时表示减少年数（等价于 YEARS_SUB(<datetime_or_date_value>, <years_value>)）。
 - 任意输入参数为 NULL，返回 NULL。
 - 若计算结果超出日期类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
@@ -90,6 +91,14 @@ SELECT YEARS_ADD(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- TimestampTz 类型示例,SET time_zone = '+08:00'
+SELECT YEARS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| YEARS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2026-10-10 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- 计算结果超出日期时间范围（上限）
 SELECT YEARS_ADD('9999-12-31', 1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation years_add of 9999-12-31, 1 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
index da721e63d13d3..2861ab4acd722 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-YEARS_SUB 函数用于在指定的日期或时间值上减少（或增加）指定数量的年数，返回调整后的日期或时间（本质是减去 years_value × 1 年）。支持处理 DATE、DATETIME 类型，年数可为正数（减少）或负数（增加）。
+YEARS_SUB 函数用于在指定的日期或时间值上减少（或增加）指定数量的年数,返回调整后的日期或时间（本质是减去 years_value × 1 年）。支持处理 DATE、DATETIME 类型,年数可为正数(减少)或负数(增加)。该函数支持 DATE、DATETIME 和 TIMESTAMPTZ 输入类型。
 
 该函数与 [date_sub 函数](./date-sub) 和 mysql 中的 [date_sub 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) 使用 YEAR 为单位的行为一致
 
@@ -22,15 +22,16 @@ YEARS_SUB(<date_or_time_expr>, <years>)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 输入的日期时间值，支持输入 date/datetime 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | 输入的日期时间值,支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion),[datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<years>` | 要减少的年数，类型为 INT,整数表示减少，负数表示增加 |
 
 ## 返回值
 
-返回与输入类型一致的结果（DATE 或 DATETIME），表示调整后的日期或时间：
+返回与输入类型一致的结果（DATE 或 DATETIME 或 TIMESTAMPTZ）,表示调整后的日期或时间,返回值类型由第一个参数的类型决定:
 
-- 若输入为 DATE 类型，返回值仍为 DATE 类型（仅调整年月日）。
-- 若输入为 DATETIME 类型，返回值仍为 DATETIME 类型（年月日调整后，时分秒保持不变）。
+- 若输入为 DATE 类型,返回值为 DATE 类型（仅调整年月日）。
+- 若输入为 DATETIME 类型,返回值为 DATETIME 类型（年月日调整后,时分秒保持不变）。
+- 若输入为 TIMESTAMPTZ 类型,返回值为 TIMESTAMPTZ 类型（包含日期、时间和时区偏移）。
 - <years_value> 为负数时表示增加年数（等价于 YEARS_ADD(<datetime_or_date_value>, <years_value>)）。
 - 任意输入参数为 NULL，返回 NULL。
 - 若计算结果超出日期类型的有效范围（0000-01-01 00:00:00 至 9999-12-31 23:59:59），返回错误。
@@ -78,6 +79,14 @@ SELECT YEARS_SUB(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- TimestampTz 类型示例,SET time_zone = '+08:00'
+SELECT YEARS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| YEARS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2024-10-10 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- 计算结果超出日期时间范围（上限）
 SELECT YEARS_SUB('9999-12-31', -1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation year_add of 9999-12-31, 1 out of range
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
index 63379ebaa961d..4b9747309288d 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md
@@ -10,7 +10,7 @@
 
 The DATE_ADD function is used to add a specified time interval to a specified date or time value and return the calculated result.
 
-- Supported input date types include DATE, DATETIME (such as '2023-12-31', '2023-12-31 23:59:59').
+- Supported input date types include DATE, DATETIME, TIMESTAMPTZ (such as '2023-12-31', '2023-12-31 23:59:59', '2023-12-31 23:59:59+08:00').
 - The time interval is specified by both a numeric value (`expr`) and a unit (`time_unit`). When `expr` is positive, it means "add", and when it is negative, it is equivalent to "subtract" the corresponding interval.
 
 ## Aliases
@@ -28,7 +28,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
 
 | Parameter | Description |
 | -- | -- |
-| `<date_or_time_expr>` | The date/time value to be processed. Supported types: datetime or date type, with a maximum precision of six decimal places for seconds (e.g., 2022-12-28 23:59:59.999999). For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | The date/time value to be processed. Supported types: datetime or date type, with a maximum precision of six decimal places for seconds (e.g., 2022-12-28 23:59:59.999999). For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<expr>` | The time interval to be added, of `INT` type |
 | `<time_unit>` | Enumeration values: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR, MINUTE_SECOND, SECOND_MICROSECOND |
 
@@ -37,6 +37,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
 Returns a result with the same type as <date_or_time_expr>:
 - When DATE type is input, returns DATE (date part only);
 - When DATETIME type input, returns DATETIME (including date and time);
+- WHEN TIMESTAMPTZ type input, returns TIMESTAMPTZ (including date, time, and timezone offset).
 - Input with scale (such as '2024-01-01 12:00:00.123') will preserve the scale, with a maximum of six decimal places.
 
 Special cases:
@@ -129,6 +130,14 @@ mysql>  select date_add("2025-10-10 10:10:10.123456", INTERVAL "1.1" SECOND_MICR
 | 2025-10-10 10:10:11.223456                                                |
 +---------------------------------------------------------------------------+
 
+-- Example of TimestampTz type, SET time_zone = '+08:00'
+select DATE_ADD('2023-01-01 23:22:33+03:00', INTERVAL 1 DAY);
++-------------------------------------------------------+
+| DATE_ADD('2023-01-01 23:22:33+03:00', INTERVAL 1 DAY) |
++-------------------------------------------------------+
+| 2023-01-03 04:22:33+08:00                             |
++-------------------------------------------------------+
+
 -- Illegal unit
 select DATE_ADD('2023-12-31 23:00:00', INTERVAL 2 sa);
 ERROR 1105 (HY000): errCode = 2, detailMessage = 
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
index 80e99653e0d0c..d9b334ce27937 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The DATE_SUB function is used to subtract a specified time interval from a given date or time value and return the calculated date or time result. It supports operations on DATE (date only) and DATETIME (date and time) types, where the time interval is defined by both a numerical value and a unit.
+The DATE_SUB function is used to subtract a specified time interval from a given date or time value and return the calculated date or time result. It supports operations on DATE (date only), DATETIME (date and time) and TIMESTAMPTZ(date, time, and timezone offset) types, where the time interval is defined by both a numerical value and a unit.
 
 This function behaves generally consistently with the [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) in MySQL, but the difference is that MySQL supports compound unit additions and subtractions, such as:
 
@@ -33,7 +33,7 @@ DATE_SUB(<date_or_time_part>, <expr> <time_unit>)
 
 | Parameter | Description |
 | -- | -- |
-| `<date_or_time_part>` | A valid date value, supporting datetime or date type. For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_part>` | A valid date value, supporting datetime or date type. For specificformats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<expr>` | The time interval to be subtracted, of type `INT` |
 | `<time_unit>` | Enumerated values: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND |
 
@@ -42,6 +42,7 @@ DATE_SUB(<date_or_time_part>, <expr> <time_unit>)
 Returns a calculated result with the same type as date:
 - When input is DATE, returns DATE (date part only);
 - When input is DATETIME, returns DATETIME (including date and time).
+- When input is TIMESTAMPTZ, returns TIMESTAMPTZ (including date, time, and timezone offset).
 - For datetime types with scale, the scale will be preserved and returned.
 
 Special cases:
@@ -101,6 +102,14 @@ mysql> select date_sub('2023-12-31 23:59:59', INTERVAL 61 QUARTER);
 | 2008-09-30 23:59:59                                  |
 +------------------------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT DATE_SUB('2024-02-05 02:03:04.123+12:00', INTERVAL 1 DAY);
++-----------------------------------------------------------+
+| DATE_SUB('2024-02-05 02:03:04.123+12:00', INTERVAL 1 DAY) |
++-----------------------------------------------------------+
+| 2024-02-03 22:03:04.123+08:00                             |
++-----------------------------------------------------------+
+
 -- Any parameter is NULL
 mysql> select date_sub('2023-01-01', INTERVAL NULL DAY);
 +-------------------------------------------+
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
index 09af01b5d3cdd..ab9f076984a41 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The HOURS_ADD function adds or subtracts a specified number of hours to/from an input date or datetime value and returns the calculated new datetime. This function supports both DATE and DATETIME input types. If the input is DATE type (containing only year, month, day), it defaults the time part to 00:00:00 before adding hours.
+The HOURS_ADD function adds or subtracts a specified number of hours to/from an input date or datetime value and returns the calculated new datetime. This function supports both DATE, DATETIME and TIMESTAMPTZ input types. If the input is DATE type (containing only year, month, day), it defaults the time part to 00:00:00 before adding hours.
 
 This function is consistent with the [date_add function](./date-add) and [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) in MySQL when using the `HOUR` unit.
 
@@ -22,13 +22,16 @@ HOURS_ADD(`<date_or_time_expr>`, `<hours>`)
 
 | Parameter | Description |
 | ---- | ---- |
-| `<date_or_time_expr>` | A valid date expression that supports date/datetime types. For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | A valid date expression that supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<hours>` | The number of hours to add, of integer (INT) type. Can be positive or negative: positive number adds the specified hours, negative number subtracts the specified hours (equivalent to subtracting hours) |
 
 ## Return Value
 
-Returns DATETIME type, representing the time value after adding or subtracting the specified number of hours from the input datetime.
+Return the base time `<date_or_time_expr>` plus the specified hours `<hours>`, the return value type is determined by the type of the first parameter:
+- If the type of the first parameter is DATE/DATETIME, then the return type is DATETIME.
+- If the type of the first parameter is TIMESTAMPTZ, then the return type is TIMESTAMPTZ.
 
+Special cases:
 - If the calculation result exceeds the valid range of DATETIME type [0000-01-01 00:00:01, 9999-12-31 23:59:59], returns an error.
 - Return NULL if any parameters is NULL.
 
@@ -60,6 +63,14 @@ select hours_add('2023-10-01 10:00:00', -3) ;
 | 2023-10-01 07:00:00                  |
 +--------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT HOURS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| HOURS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-10 13:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- Input parameter is NULL, return NULL
 select hours_add(null, 5) ;
 +--------------------+
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
index eaeb265d8b5b3..2593e7bf47399 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/hours-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The HOURS_SUB function subtracts a specified number of hours from an input date or datetime value and returns the calculated new datetime. This function supports both DATE and DATETIME input types. If the input is DATE type (containing only year, month, day), it defaults the time part to 00:00:00.
+The HOURS_SUB function subtracts a specified number of hours from an input date or datetime value and returns the calculated new datetime. This function supports both DATE, DATETIME and TIMESTAMPTZ input types. If the input is DATE type (containing only year, month, day), it defaults the time part to 00:00:00.
 
 This function is consistent with the [date_sub function](./date-sub) and [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) in MySQL when using the `HOUR` unit.
 
@@ -22,13 +22,16 @@ HOURS_SUB(`<date_or_time_expr>`, `<hours>`)
 
 | Parameter | Description |
 | ---- | ---- |
-| `<date_or_time_expr>` | A valid date expression that supports date/datetime types. For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | A valid date expression that supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<hours>` | The number of hours to subtract, of INT type |
 
 ## Return Value
 
-Returns a DATETIME type value representing the datetime after adding or subtracting the specified hours (format: YYYY-MM-DD HH:MM:SS).
+Return the base time `<date_or_time_expr>` minus the specified hours `<hours>`, the return value type is determined by the type of the first parameter:
+- If the type of the first parameter is DATE/DATETIME, then the return type is DATETIME.
+- If the type of the first parameter is TIMESTAMPTZ, then the return type is TIMESTAMPTZ
 
+Special cases:
 - If the calculation result exceeds the valid range of DATETIME type (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns an error.
 - If any input parameter is NULL, returns NULL.
 - If input hours is negative, returns the datetime plus the corresponding number of hours.
@@ -61,6 +64,14 @@ select hours_sub('2023-10-01 10:00:00', -3);
 | 2023-10-01 13:00:00                  |
 +--------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT HOURS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| HOURS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-10 11:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- Any parameter is NULL, return NULL
 select hours_sub('2023-10-01 10:00:00', NULL);
 +----------------------------------------+
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
index 7e9c3f3a72227..cd2e22747f9f9 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-add.md
@@ -8,26 +8,28 @@
 
 ## Description
 
-The MICROSECONDS_ADD function adds a specified number of microseconds to the input datetime value and returns the resulting new datetime value. This function supports processing DATETIME types with microsecond precision.
+The MICROSECONDS_ADD function adds a specified number of microseconds to the input datetime value and returns the resulting new datetime value. This function supports processing DATETIME or TIMESTAMPTZ types with microsecond precision.
 
 This function behaves the same as MySQL’s [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) when using MICROSECOND as the unit.
 
 ## Syntax
 
 ```sql
-MICROSECONDS_ADD(`<datetime>`, `<delta>`)
+MICROSECONDS_ADD(`<datetime_like_type>`, `<delta>`)
 ```
 
 ## Parameters
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<datetime>` | The input datetime value, of type DATETIME. For datetime formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
+| `<datetime_like_type>` | The input datetime value, of type DATETIME or TIMESTAMPTZ. For formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
 | `<delta>` | The number of microseconds to add, of type BIGINT. 1 second = 1,000,000 microseconds. |
 
 ## Return Value
 
-Returns a DATETIME type value, representing the result of adding the specified microseconds to the base time (formatted as YYYY-MM-DD HH:MM:SS.ffffff, where the fractional part precision matches the datetime precision).
+Return the result of adding the specified microseconds `<delta>` to the base time `<datetime_like_type>`, with the return type being the same as the type of the first parameter.
+- If the first parameter is TIMESTAMPTZ, then return TIMESTAMPTZ.
+- If the first parameter is DATETIME, then return DATETIME.
 
 - If `<delta>` is negative, the function subtracts the corresponding microseconds from the base time (i.e., MICROSECONDS_ADD(basetime, -n) is equivalent to MICROSECONDS_SUB(basetime, n)).
 - If the calculation result exceeds the valid range of the DATETIME type (0000-01-01 00:00:00 to 9999-12-31 23:59:59.999999), an exception is thrown.
@@ -61,6 +63,14 @@ SELECT MICROSECONDS_ADD('2023-10-01', -300000);
 | 2023-09-30 23:59:59.700000              |
 +-----------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MICROSECONDS_ADD('2024-12-25 12:34:56.123+04:00', '765800');
++-------------------------------------------------------------+
+| MICROSECONDS_ADD('2024-12-25 12:34:56.123+04:00', '765800') |
++-------------------------------------------------------------+
+| 2024-12-25 16:34:56.888800+08:00                            |
++-------------------------------------------------------------+
+
 -- Calculation result exceeds datetime range, throws error
 SELECT MICROSECONDS_ADD('9999-12-31 23:59:59.999999', 2000000) AS after_add;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 9999-12-31 23:59:59.999999, 2000000 out of range
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
index 1351e075b3d23..d4f2c4f666e0a 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/microseconds-sub.md
@@ -8,26 +8,26 @@
 
 ## Description
 
-The `MICROSECONDS_SUB` function subtracts a specified number of microseconds from the input datetime value and returns the resulting new datetime value. This function supports processing `DATETIME` types with microsecond precision.
+The `MICROSECONDS_SUB` function subtracts a specified number of microseconds from the input datetime value and returns the resulting new datetime value. This function supports processing `DATETIME` and `TIMESTAMPTZ` types with microsecond precision.
 
 This function behaves the same as MySQL’s [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) when using MICROSECOND as the unit.
 
 ## Syntax
 
 ```sql
-MICROSECONDS_SUB(`<datetime>`, `<delta>`)
+MICROSECONDS_SUB(`<datetime_like_type>`, `<delta>`)
 ```
 
 ## Parameters
 
 | Parameter    | Description                                                                                     |
 |--------------|-------------------------------------------------------------------------------------------------|
-| `<datetime>` | The input datetime value, of type `DATETIME`. For specific datetime formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion). |
+| `<datetime_like_type>` | The input datetime value, of type `DATETIME` or `TIMESTAMPTZ`. For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion). |
 | `<delta>`    | The number of microseconds to subtract, of type `BIGINT`. 1 second = 1,000,000 microseconds.       |
 
 ## Return Value
 
-Returns a value of type `DATETIME`, representing the result of subtracting the specified number of microseconds from the base time.
+Return the result of subtracting the specified microseconds `<delta>` from the base time `<datetime_like_type>`, with the return type being the same as the type of the first parameter.
 
 - If `<delta>` is negative, the function behaves the same as adding the corresponding number of microseconds to the base time (i.e., `MICROSECONDS_SUB(basetime, -n)` is equivalent to `MICROSECONDS_ADD(basetime, n)`).
 - If the calculation result exceeds the valid range of the `DATETIME` type (`0000-01-01 00:00:00` to `9999-12-31 23:59:59.999999`), an exception is thrown.
@@ -69,6 +69,14 @@ SELECT MICROSECONDS_SUB('2023-10-01', -300000);
 | 2023-10-01 00:00:00.300000              |
 +-----------------------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800');
++-------------------------------------------------------------+
+| MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800') |
++-------------------------------------------------------------+
+| 2024-12-25 16:34:55.357200+08:00                            |
++-------------------------------------------------------------+
+
 -- Exceeds datetime range, throws an error
 mysql> SELECT MICROSECONDS_SUB('0000-01-01 00:00:00.000000', 1000000) AS after_sub;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 0000-01-01 00:00:00, -1000000 
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
index 2ad6166ab1240..19054c2d672fe 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The MINUTES_ADD function adds a specified number of minutes to the input datetime value and returns the resulting new datetime value. This function supports processing DATE and DATETIME types.
+The MINUTES_ADD function adds a specified number of minutes to the input datetime value and returns the resulting new datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types.
 
 This function is consistent with [date_add function](./date-add) and MySQL's [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) when using MINUTE as the unit.
 
@@ -22,13 +22,16 @@ MINUTES_ADD(`<date_or_time_expr>`, `<minutes>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input datetime value, which can be of type DATE or DATETIME. For specific datetime/date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | The input datetime value, which can be of type DATE, DATETIME or TIMESTAMPTZ. For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<minutes>` | The number of minutes to add, of type BIGINT. |
 
 ## Return Value
 
-Returns a value of type DATETIME, representing the result of adding the specified minutes to the base time.
+Return the result of adding the specified minutes `<minutes>` to the base time `<datetime_like_type>`, with the return type related to the first parameter type:
+- If the first parameter is TIMESTAMPTZ, then return TIMESTAMPTZ.
+- If the first parameter is DATETIME, then return DATETIME.
 
+Special cases:
 - If `<minutes>` is negative, the function behaves the same as subtracting the corresponding minutes from the base time (i.e., MINUTES_ADD(date, -n) is equivalent to MINUTES_SUB(date, n)).
 - If the input is of DATE type (only includes year, month, and day), its time part defaults to 00:00:00.
 - If the input datetime includes microseconds, the original microsecond precision is preserved after adding minutes (e.g., '2023-01-01 00:00:00.123456' becomes '2023-01-01 00:01:00.123456' after adding 1 minute).
@@ -70,6 +73,14 @@ SELECT MINUTES_ADD('2023-07-13 22:28:18', -5) AS result;
 | 2023-07-13 22:23:18 |
 +---------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| MINUTES_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:23:33.123+08:00                   |
++-------------------------------------------------+
+
 -- Any parameter is NULL, returns NULL
 SELECT MINUTES_ADD(NULL, 10), MINUTES_ADD('2023-07-13 22:28:18', NULL) AS result;
 +-------------------------+--------+
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
index eab65d88513f7..4a09415cff071 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The MINUTES_SUB function subtracts a specified number of minutes from the input datetime value and returns the resulting new datetime value. This function supports processing DATE and DATETIME types.
+The MINUTES_SUB function subtracts a specified number of minutes from the input datetime value and returns the resulting new datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types.
 
 This function is consistent with [date_sub function](./date-sub) and MySQL's [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) when using MINUTE as the unit.
 
@@ -22,13 +22,16 @@ MINUTES_SUB(`<date_or_time_expr>`, `<minutes>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input datetime value, which can be of type DATE or DATETIME. For specific datetime/date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
+| `<date_or_time_expr>` | The input datetime value, which can be of type DATE, DATETIME or TIMESTAMPTZ. For specific datetime/date formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
 | `<minutes>` | The number of minutes to subtract, of type BIGINT. Can be positive or negative. |
 
 ## Return Value
 
-Returns a value of type DATETIME, representing the datetime value after subtracting the specified number of minutes.
+Return the result of subtracting the specified minutes `<minutes>` from the base time `<datetime_like_type>`, with the return type being related to the type of the first parameter:
+- If the first parameter is TIMESTAMPTZ, then return TIMESTAMPTZ.
+- If the first parameter is DATETIME, then return DATETIME.
 
+Special cases:
 - If `<minutes>` is negative, the function behaves the same as adding the corresponding minutes to the base time (i.e., MINUTES_SUB(date, -n) is equivalent to MINUTES_ADD(date, n)).
 - If the input is of DATE type (only includes year, month, and day), its time part defaults to 00:00:00.
 - If the input datetime includes microseconds, the original microsecond precision is preserved after subtracting minutes (e.g., '2023-01-01 00:01:00.123456' becomes '2023-01-01 00:00:00.123456' after subtracting 1 minute).
@@ -70,6 +73,14 @@ SELECT MINUTES_SUB('2023-07-13', 30) AS result;
 | 2023-07-12 23:30:00 |
 +---------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MINUTES_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| MINUTES_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:21:33.123+08:00                   |
++-------------------------------------------------+
+
 -- Any parameter is NULL, returns NULL
 SELECT MINUTES_SUB(NULL, 10), MINUTES_SUB('2023-07-13 22:28:18', NULL) AS result;
 +-----------------------+--------+
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
index 6ef7acd6f0358..f0927a9bf0038 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The MONTHS_ADD function adds a specified number of months to the input datetime value and returns the resulting new datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to subtracting the corresponding number of months.
+The MONTHS_ADD function adds a specified number of months to the input datetime value and returns the resulting new datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types. If a negative number is input, it is equivalent to subtracting the corresponding number of months.
 
 This function is consistent with [date_add function](./date-add) and MySQL's [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add) when using MONTH as the unit.
 
@@ -22,15 +22,14 @@ MONTHS_ADD(`<date_or_time_expr>`, `<nums>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input datetime value. Supports date/datetime types. For specific datetime and date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
+| `<date_or_time_expr>` | The input datetime value. Supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
 | `<nums>` | The number of months to add or subtract, of type INT. Negative numbers indicate subtracting nums months from the datetime, positive numbers indicate adding nums months. |
 
 ## Return Value
 
-Returns a value of the same type as the input `<date_or_time_expr>` (DATE or DATETIME), representing the result of adding the specified months to the base time.
+Returns a value of the same type as the input `<date_or_time_expr>`(DATE, DATETIME or TIMESTAMPTZ), representing the result of adding the specified months to the base time.
 
 - If `<nums>` is negative, the function behaves the same as subtracting the corresponding months from the base time (i.e., MONTHS_ADD(date, -n) is equivalent to MONTHS_SUB(date, n)).
-- If the input is of DATE type (only includes year, month, and day), the result remains of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-01-01 12:34:56' becomes '2023-02-01 12:34:56' after adding 1 month).
 - If the input date is the last day of the month and the target month has fewer days than that date, it automatically adjusts to the last day of the target month (e.g., January 31st plus 1 month becomes February 28th or 29th, depending on whether it's a leap year).
 - If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns an error.
 - If any parameter is NULL, returns NULL.
@@ -86,6 +85,14 @@ SELECT MONTHS_ADD(NULL, 5), MONTHS_ADD('2023-07-13', NULL) AS result;
 | NULL                 | NULL   |
 +----------------------+--------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MONTHS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++------------------------------------------------+
+| MONTHS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++------------------------------------------------+
+| 2025-11-10 12:22:33.123+08:00                  |
++------------------------------------------------+
+
 -- Calculation result exceeds date range
 SELECT MONTHS_ADD('9999-12-31', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation months_add of 9999-12-31, 1 out of range
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
index 4de90b66ce022..0f1039e18deb1 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/months-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The MONTHS_SUB function subtracts a specified number of months from the input datetime value and returns the resulting new datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to adding the corresponding number of months.
+The MONTHS_SUB function subtracts a specified number of months from the input datetime value and returns the resulting new datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types. If a negative number is input, it is equivalent to adding the corresponding number of months.
 
 This function is consistent with [date_sub function](./date-sub) and MySQL's [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_sub) when using MONTH as the unit.
 
@@ -22,15 +22,14 @@ MONTHS_SUB(`<date_or_time_expr>`, `<nums>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The date value from which to subtract months. Supports date/datetime types. For specific datetime and date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | The date value from which to subtract months. Supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<nums>` | The number of months to subtract, of type INT. Positive numbers indicate subtracting nums months from the datetime, negative numbers indicate adding nums months. |
 
 ## Return Value
 
-Returns a value of the same type as the input `<date_or_time_expr>` (DATE or DATETIME), representing the result of subtracting the specified months from the base time.
+Returns a value of the same type as the input `<date_or_time_expr>`(DATE, DATETIME or TIMESTAMPTZ), representing the result of subtracting the specified months from the base time.
 
 - If `<nums>` is negative, the function behaves the same as adding the corresponding months to the base time (i.e., MONTHS_SUB(date, -n) is equivalent to MONTHS_ADD(date, n)).
-- If the input is of DATE type (only includes year, month, and day), the result remains of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-03-01 12:34:56' becomes '2023-02-01 12:34:56' after subtracting 1 month).
 - If the input date is the last day of the month and the target month has fewer days than that date, it automatically adjusts to the last day of the target month (e.g., March 31st minus 1 month becomes February 28th or 29th, depending on whether it's a leap year).
 - If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns an error.
 - If any parameter is NULL, returns NULL.
@@ -86,6 +85,14 @@ SELECT MONTHS_SUB(NULL, 5), MONTHS_SUB('2023-07-13', NULL) AS result;
 | NULL                 | NULL   |
 +----------------------+--------+
 
+--- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT MONTHS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++------------------------------------------------+
+| MONTHS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++------------------------------------------------+
+| 2025-09-10 12:22:33.123+08:00                  |
++------------------------------------------------+
+
 --- Calculation result exceeds date range
 mysql> SELECT MONTHS_SUB('0000-01-01', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation months_add of 0000-01-01, -1 out of range
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
index f1e098635dc44..77fd42a35a1fd 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The QUARTERS_ADD function is used to add or subtract a specified number of quarters (1 quarter = 3 months) to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to subtracting the corresponding number of quarters.
+The QUARTERS_ADD function is used to add or subtract a specified number of quarters (1 quarter = 3 months) to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to subtracting the corresponding number of quarters. This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function is consistent with the [date_add function](./date-add) when using QUARTER as the unit.
 
@@ -22,14 +22,15 @@ QUARTERS_ADD(`<date_or_time_expr>`, `<quarters>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input date or datetime value. Supports date/datetime types. For specific datetime and date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
+| `<date_or_time_expr>` | The input date or datetime value. Supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
 | `<quarters>` | The number of quarters to add or subtract. Positive integers indicate addition, negative integers indicate subtraction. |
 
 ## Return Value
 
-Returns a date value consistent with the input date type.
+Returns a date value consistent with the input date type, the return value type is determined by the type of the first parameter:
 - If `<quarters>` is negative, the function behaves the same as subtracting the corresponding number of quarters from the base time (i.e., QUARTERS_ADD(date, -n) is equivalent to QUARTERS_SUB(date, n)).
-- If the input is of DATE type (only includes year, month, and day), the result remains of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-01-01 12:34:56' becomes '2023-04-01 12:34:56' after adding 1 quarter).
+- If the input is of DATE type (only includes year, month, and day), the result is of DATE type; if the input is of DATETIME type, the result is of DATETIME type and preserves the original time component (e.g., '2023-01-01 12:34:56' becomes '2023-04-01 12:34:56' after adding 1 quarter).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
 - If the input date is the last day of the month and the target month has fewer days than that date, it automatically adjusts to the last day of the target month (e.g., January 31st plus 1 quarter (3 months) becomes April 30th).
 - If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59), throws an exception.
 - If any parameter is NULL, returns NULL.
@@ -93,6 +94,14 @@ SELECT QUARTERS_ADD(NULL, 1), QUARTERS_ADD('2023-07-13', NULL) AS result;
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+--- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT QUARTERS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++--------------------------------------------------+
+| QUARTERS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++--------------------------------------------------+
+| 2026-01-10 12:22:33.123+08:00                    |
++--------------------------------------------------+
+
 --- Calculation result exceeds date range
 SELECT QUARTERS_ADD('9999-10-31', 2) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation month_add of 9999-10-31, 6 out of range
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
index 40666721794cb..a124e66d3564b 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/quarters-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The QUARTERS_SUB function is used to subtract or add a specified number of quarters (1 quarter = 3 months) to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to adding the corresponding number of quarters.
+The QUARTERS_SUB function is used to subtract or add a specified number of quarters (1 quarter = 3 months) from a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to adding the corresponding number of quarters. This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function behaves consistently with the [date_sub function](./date-sub) when using QUARTER as the unit.
 
@@ -22,15 +22,18 @@ QUARTERS_SUB(`<date_or_time_expr>`, `<quarters>`)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | The input date or datetime value. Supports date/datetime types. For specific datetime and date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
+| `<date_or_time_expr>` | The input date or datetime value. Supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion). |
 | `<quarters>` | The number of quarters to add or subtract. Positive integers indicate subtraction, negative integers indicate addition. |
 
 ## Return Value
 
-Returns a date value consistent with the input date type.
+Returns a date value consistent with the input date type, the return value type is determined by the type of the first parameter:
 
+- If the input is of DATE type (only includes year, month, and day), the result is of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-04-01 12:34:56' becomes '2023-01-01 12:34:56' after subtracting 1 quarter).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
+
+Special cases:
 - If `<quarters>` is negative, the function behaves the same as adding the corresponding number of quarters to the base time (i.e., QUARTERS_SUB(date, -n) is equivalent to QUARTERS_ADD(date, n)).
-- If the input is of DATE type (only includes year, month, and day), the result remains of DATE type; if the input is of DATETIME type, the result preserves the original time component (e.g., '2023-04-01 12:34:56' becomes '2023-01-01 12:34:56' after subtracting 1 quarter).
 - If the input date is the last day of the month and the target month has fewer days than that date, it automatically adjusts to the last day of the target month (e.g., April 30th minus 1 quarter (3 months) becomes January 31st).
 - If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59), throws an exception.
 - If any parameter is NULL, returns NULL.
@@ -94,6 +97,14 @@ SELECT QUARTERS_SUB(NULL, 1), QUARTERS_SUB('2023-07-13', NULL) AS result;
 | NULL                    | NULL   |
 +-------------------------+--------+
 
+--- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT QUARTERS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++--------------------------------------------------+
+| QUARTERS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++--------------------------------------------------+
+| 2025-07-10 12:22:33.123+08:00                    |
++--------------------------------------------------+
+
 --- Calculation result exceeds date range
 SELECT QUARTERS_SUB('0000-04-30', 1) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation quarters_sub of 0000-04-30, 1 out of range
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
index b84f1e96b38b7..d81bbcf943c4c 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The SECONDS_ADD function adds or subtracts a specified number of seconds to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to subtracting the corresponding number of seconds.
+The SECONDS_ADD function adds or subtracts a specified number of seconds to a specified datetime value and returns the calculated datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types. If a negative number is input, it is equivalent to subtracting the corresponding number of seconds.
 
 This function is consistent with [date_add function](./date-add) and MySQL's [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) when using SECOND as the unit.
 
@@ -22,16 +22,19 @@ SECONDS_ADD(<date_or_time_expr>, <seconds>)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | Required. The input datetime value. Can be of type DATE or DATETIME. For specific datetime/date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | Required. The input datetime value. Can be of type DATE, DATETIME or TIMESTAMPTZ. For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<seconds>` | Required. The number of seconds to add or subtract. Supports integer type (BIGINT). Positive numbers indicate adding seconds, negative numbers indicate subtracting seconds. |
 
 ## Return Value
 
-Returns a datetime value with the same type as the input `<date_or_time_expr>`.
+Return the base time `<date_or_time_expr>` by adding the specified number of seconds `<second>`, the return value type is determined by the type of the first parameter:
+- If the type of the first parameter is DATE/DATETIME, then the return type is DATETIME.
+- If the type of the first parameter is TIMESTAMPTZ, then the return type is TIMESTAMPTZ.
 
+Special cases:
 - If `<seconds>` is negative, the function behaves the same as subtracting the corresponding seconds from the base time (i.e., SECONDS_ADD(date, -n) is equivalent to SECONDS_SUB(date, n)).
 - If the input is DATE type (only contains year, month, day), its time portion defaults to 00:00:00.
-- If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59.999999), returns an error.
+- If the calculation result exceeds the valid range of the date type (DATE type: 0000-01-01 to 9999-12-31; DATETIME/TIMESTAMPTZ type: 0000-01-01 00:00:00 to 9999-12-31 23:59:59.999999), returns an error.
 - If any parameter is NULL, returns NULL.
 
 ## Examples
@@ -77,6 +80,14 @@ SELECT SECONDS_ADD('2023-07-13 10:30:25.123456', 2) AS result;
 | 2023-07-13 10:30:27.123456 |
 +----------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| SECONDS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:22:34.123+08:00                   |
++-------------------------------------------------+
+
 --- Returns NULL when input is NULL
 SELECT SECONDS_ADD(NULL, 30), SECONDS_ADD('2025-01-23 12:34:56', NULL) AS result;
 +-------------------------+--------+
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
index 5ee94e5727ecb..217f350697396 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The SECONDS_SUB function subtracts or adds a specified number of seconds to a specified datetime value and returns the calculated datetime value. This function supports processing DATE and DATETIME types. If a negative number is input, it is equivalent to adding the corresponding number of seconds.
+The SECONDS_SUB function subtracts or adds a specified number of seconds to a specified datetime value and returns the calculated datetime value. This function supports processing DATE, DATETIME and TIMESTAMPTZ types. If a negative number is input, it is equivalent to adding the corresponding number of seconds.
 
 This function is consistent with [date_sub function](./date-sub) and MySQL's [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) when using SECOND as the unit.
 
@@ -22,13 +22,16 @@ SECONDS_SUB(<date_or_time_expr>, <seconds>)
 
 | Parameter | Description |
 | --------- | ----------- |
-| `<date_or_time_expr>` | Required. The input datetime value. Can be of type DATE or DATETIME. For specific datetime/date formats, see [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | Required. The input datetime value. Can be of type DATE, DATETIME or TIMESTAMPTZ. For specific formats, see [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<seconds>` | Required. The number of seconds to subtract or add. Supports integer type (BIGINT). Positive numbers indicate subtracting seconds, negative numbers indicate adding seconds. |
 
 ## Return Value
 
-Returns a datetime value after adding the corresponding seconds to the input datetime, of type DATETIME.
-
+Returns the value of the base time `<date_or_time_expr>` minus the specified number of seconds `<second>`, and the return type is determined by the type of the first parameter:
+- If the type of the first parameter is DATE/DATETIME, it returns a DATETIME type.
+- If the type of the first parameter is TIMESTAMPTZ, it returns a TIMESTAMPTZ type.
+  
+Special cases:
 - If `<seconds>` is negative, the function behaves the same as adding the corresponding seconds to the base time (i.e., SECONDS_SUB(date, -n) is equivalent to SECONDS_ADD(date, n)).
 - If the input is DATE type (only contains year, month, day), its time portion defaults to 00:00:00.
 - If the calculation result exceeds the valid range of the date type (for DATE type: throws an exception).
@@ -77,6 +80,14 @@ SELECT SECONDS_SUB('2023-07-13 10:30:25.123456', 2) AS result;
 | 2023-07-13 10:30:23.123456 |
 +----------------------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT SECONDS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-------------------------------------------------+
+| SECONDS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-------------------------------------------------+
+| 2025-10-10 12:22:32.123+08:00                   |
++-------------------------------------------------+
+
 --- Returns NULL when input is NULL
 SELECT SECONDS_SUB(NULL, 30), SECONDS_SUB('2025-01-23 12:34:56', NULL) AS result;
 +-------------------------+--------+
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
index ede88bc749c39..2c09aa7fc6299 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-add.md
@@ -8,7 +8,7 @@
 
 ## Description 
 
-The WEEKS_ADD function is used to add (or subtract) a specified number of weeks to a given date or time value, equivalent to adding/subtracting seven days to the original date, returning the adjusted date or time.
+The WEEKS_ADD function is used to add (or subtract) a specified number of weeks to a given date or time value, equivalent to adding/subtracting seven days to the original date, returning the adjusted date or time. This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function behaves consistently with the [weeks_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_weeks-add) using WEEK as the unit in MySQL.
 
@@ -20,15 +20,18 @@ WEEKS_ADD(`<datetime_or_date_expr>`, `<weeks_value>`)
 ## Parameters
 | Parameter | Description |
 |-----------|-------------|
-| `<datetime_or_date_expr>` | Input datetime value, supports date/datetime types. For datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<datetime_or_date_expr>` | Input datetime value, supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<weeks_value>` | INT type integer, representing the number of weeks to add or subtract (positive for addition, negative for subtraction) |
 
 ## Return Value
 
-Returns the datetime with the specified number of weeks added.
+Returns the datetime with the specified number of weeks added, the return value type is determined by the type of the first parameter:
 
-- If input is DATE type, return value remains DATE type (only adjusts year, month, day).
-- If input is DATETIME type, return value remains DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is DATE type, return value is DATE type (only adjusts year, month, day).
+- If input is DATETIME type, return value is DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
+
+Special cases:
 - `<weeks_value>` as negative number indicates subtracting weeks.
 - Any input parameter is NULL, returns NULL
 - If calculation result exceeds valid date type range (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns error
@@ -74,6 +77,14 @@ SELECT WEEKS_ADD(NULL, 5) AS null_input;
 +------------+
 | NULL       |
 +------------+
+
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT WEEKS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| WEEKS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-17 12:22:33.123+08:00                 |
++-----------------------------------------------+
 ```
 
 
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
index a709ab5c36806..91d4e0a77cc84 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/weeks-sub.md
@@ -7,7 +7,7 @@
 ---
 
 ## Description
-The WEEKS_SUB function is used to subtract (or add) a specified number of weeks from a given date or time value, returning the adjusted date or time (essentially subtracting weeks_value × 7 days). It supports processing DATE and DATETIME types.
+The WEEKS_SUB function is used to subtract (or add) a specified number of weeks from a given date or time value, returning the adjusted date or time (essentially subtracting weeks_value × 7 days). It supports processing DATE, DATETIME and TIMESTAMPTZ types.
 
 This function is consistent with the [weeks_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_weeks-sub) using WEEK as the unit in MySQL.
 
@@ -19,14 +19,17 @@ WEEKS_SUB(`<date_or_time_expr>`, `<week_period>`)
 ## Parameters
 | Parameter | Description |
 |-----------|-------------|
-| `<date_or_time_expr>` | Input datetime value, supports date/datetime types. For datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | Input datetime value, supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `week_period` | INT type integer, representing the number of weeks to subtract (positive for subtraction, negative for addition). |
 
 ## Return Value
-Returns the date or time with the specified number of weeks subtracted:
+Returns the date or time with the specified number of weeks subtracted, the return value type is determined by the type of the first parameter:
 
-- If input is DATE type, return value remains DATE type (only adjusts year, month, day).
-- If input is DATETIME type, return value remains DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is DATE type, return value is DATE type (only adjusts year, month, day).
+- If input is DATETIME type, return value is DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
+
+Special cases:
 - `<weeks_value>` as negative number indicates adding weeks (equivalent to WEEKS_ADD(`<datetime_or_date_value>`, `<weeks_value>`)).
 - Any input parameter is NULL, returns NULL.
 - If calculation result exceeds valid date type range (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns error.
@@ -73,6 +76,14 @@ SELECT WEEKS_SUB(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT WEEKS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| WEEKS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2025-10-03 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- The calculation result exceeds the lower bound of the datetime range.
 SELECT WEEKS_SUB('0000-01-01', 1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation weeks_add of 0000-01-01, -1 out of range
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
index babb31bf14754..931be53893c28 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-add.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The YEARS_ADD function is used to add (or subtract) a specified number of years to a given date or time value, returning the adjusted date or time. It supports processing DATE and DATETIME types, where the number of years can be positive (addition) or negative (subtraction).
+The YEARS_ADD function is used to add (or subtract) a specified number of years to a given date or time value, returning the adjusted date or time. It supports processing DATE and DATETIME types, where the number of years can be positive (addition) or negative (subtraction). This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function is consistent with the [date_add function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-add) using YEAR as the unit in MySQL.
 
@@ -22,16 +22,17 @@ YEARS_ADD(`<date_or_time_expr>`, `<years>`)
 
 | Parameter | Description |
 |-----------|-------------|
-| `<date_or_time_expr>` | Input datetime value, supports date/datetime types. For datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | Input datetime value, supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<years>` | Number of years to add, type INT, negative numbers indicate subtraction, positive numbers indicate addition |
 
 
 ## Return Value
 
-Returns a result consistent with the input type (DATE or DATETIME), representing the adjusted date or time:
+Returns a result consistent with the input type (DATE or DATETIME or TIMESTAMPTZ), representing the adjusted date or time, the return value type is determined by the type of the first parameter:
 
-- If input is DATE type, return value remains DATE type (only adjusts year, month, day).
-- If input is DATETIME type, return value remains DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is DATE type, return value is DATE type (only adjusts year, month, day).
+- If input is DATETIME type, return value is DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
 - `<years_value>` as negative number indicates subtracting years (equivalent to YEARS_SUB(`<datetime_or_date_value>`, `<years_value>`)).
 - Any input parameter is NULL, returns NULL.
 - If calculation result exceeds valid date type range (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns error.
@@ -88,6 +89,14 @@ SELECT YEARS_ADD(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT YEARS_ADD('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| YEARS_ADD('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2026-10-10 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- Calculation result exceeds datetime range (upper limit)
 SELECT YEARS_ADD('9999-12-31', 1);
 -- ERROR: Operation out of range
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
index 52b881fbb6d56..66a19eb5e2a53 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/years-sub.md
@@ -8,7 +8,7 @@
 
 ## Description
 
-The YEARS_SUB function is used to subtract (or add) a specified number of years from a given date or time value, returning the adjusted date or time (essentially subtracting years_value × 1 year). It supports processing DATE and DATETIME types, where the number of years can be positive (subtraction) or negative (addition).
+The YEARS_SUB function is used to subtract (or add) a specified number of years from a given date or time value, returning the adjusted date or time (essentially subtracting years_value × 1 year). It supports processing DATE and DATETIME types, where the number of years can be positive (subtraction) or negative (addition). This function supports DATE, DATETIME and TIMESTAMPTZ input types.
 
 This function behaves consistently with the [date_sub function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date-sub) using YEAR as the unit in MySQL.
 
@@ -22,15 +22,16 @@ YEARS_SUB(`<date_or_time_expr>`, `<years>`)
 
 | Parameter | Description |
 |-----------|-------------|
-| `<date_or_time_expr>` | Input datetime value, supports date/datetime types. For datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
+| `<date_or_time_expr>` | Input datetime value, supports date/datetime/timestamptz types. For specific formats, please refer to [timestamptz conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)  |
 | `<years>` | Number of years to subtract, type INT, positive numbers indicate subtraction, negative numbers indicate addition |
 
 ## Return Value
 
-Returns a result consistent with the input type (DATE or DATETIME), representing the adjusted date or time:
+Returns a result consistent with the input type (DATE or DATETIME or TIMESTAMPTZ), representing the adjusted date or time, the return value type is determined by the type of the first parameter:
 
-- If input is DATE type, return value remains DATE type (only adjusts year, month, day).
-- If input is DATETIME type, return value remains DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is DATE type, return value is DATE type (only adjusts year, month, day).
+- If input is DATETIME type, return value is DATETIME type (year, month, day adjusted, hours, minutes, seconds remain unchanged).
+- If input is TIMESTAMPTZ type, return value is TIMESTAMPTZ type (includes date, time and timezone offset).
 - `<years_value>` as negative number indicates adding years (equivalent to YEARS_ADD(`<datetime_or_date_value>`, `<years_value>`)).
 - Any input parameter is NULL, returns NULL.
 - If calculation result exceeds valid date type range (0000-01-01 00:00:00 to 9999-12-31 23:59:59), returns error.
@@ -79,6 +80,14 @@ SELECT YEARS_SUB(NULL, 5) AS null_input;
 | NULL       |
 +------------+
 
+-- Example of TimeStampTz type, SET time_zone = '+08:00'
+SELECT YEARS_SUB('2025-10-10 11:22:33.123+07:00', 1);
++-----------------------------------------------+
+| YEARS_SUB('2025-10-10 11:22:33.123+07:00', 1) |
++-----------------------------------------------+
+| 2024-10-10 12:22:33.123+08:00                 |
++-----------------------------------------------+
+
 -- Calculation result exceeds datetime range (upper limit)
 SELECT YEARS_SUB('9999-12-31', -1);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation year_add of 9999-12-31, 1 out of range

From 7ac957527b243ec429e23ce25860452676967d9b Mon Sep 17 00:00:00 2001
From: linzhenqi <linzhenqi@selectdb.com>
Date: Mon, 5 Jan 2026 13:25:51 +0800
Subject: [PATCH 3/3] CN-temp

---
 .../date-time-functions/date-ceil.md          | 16 +++++--
 .../date-time-functions/date-floor.md         | 18 +++++++-
 .../date-time-functions/date-trunc.md         | 18 +++++---
 .../date-time-functions/day-ceil.md           | 26 +++++++++--
 .../date-time-functions/day-floor.md          | 26 +++++++++--
 .../date-time-functions/hour-ceil.md          | 23 +++++++++-
 .../date-time-functions/hour-floor.md         | 23 +++++++++-
 .../date-time-functions/minute-ceil.md        | 23 +++++++++-
 .../date-time-functions/minute-floor.md       | 23 +++++++++-
 .../date-time-functions/month-ceil.md         | 23 +++++++++-
 .../date-time-functions/month-floor.md        | 43 +++++++++++++------
 .../date-time-functions/quarter-ceil.md       | 23 +++++++++-
 .../date-time-functions/quarter-floor.md      | 23 +++++++++-
 .../date-time-functions/second-ceil.md        | 23 +++++++++-
 .../date-time-functions/second-floor.md       | 23 +++++++++-
 .../date-time-functions/to-iso8601.md         | 24 +++++++----
 .../date-time-functions/week-ceil.md          | 23 +++++++++-
 .../date-time-functions/week-floor.md         | 24 ++++++++++-
 .../date-time-functions/year-ceil.md          | 23 +++++++++-
 .../date-time-functions/year-floor.md         | 23 +++++++++-
 20 files changed, 407 insertions(+), 64 deletions(-)

diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-ceil.md
index 8914ec5a1fe7d..712474c008624 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-ceil.md
@@ -30,14 +30,16 @@ $type$ 代表的是周期单位
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入为 timestamptz, datetime 或者 date 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<period>` | 参数是指定每个周期有多少个单位组成，类型为 INT, 开始的时间起点为 0001-01-01T00:00:00 |
 | `<type>` | 参数可以是：YEAR, QUARTER, MONTH, WEEK ,DAY, HOUR, MINUTE, SECOND|
 
 ## 返回值
 
-返回的是一个日期或时间值，表示将输入值向上舍入到指定单位的结果。
-返回与 datetime 类型一致的取整结果：
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE。返回的是一个日期或时间值，表示将输入值向上舍入到指定单位的结果。
+
+返回与 `<date_or_time_expr>` 类型一致的取整结果：
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 DATE_CEIL 计算操作。
 - 输入 DATE 类型时，返回 DATE（仅日期部分）；
 - 输入 DATETIME 类型，返回 DATETIME（包含日期和时间）。
 - 输出 TIMESTAMPTZ 类型，返回 TIMESTAMPTZ（包含日期、时间和偏移量）。
@@ -125,6 +127,14 @@ SELECT DATE_CEIL('2025-12-31 23:59:59+05:00', INTERVAL 1 YEAR);
 | 2027-01-01 00:00:00                                     |
 +---------------------------------------------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 DATE_CEIL 操作
+SELECT DATE_CEIL('2025-12-31 23:59:59+05:00', INTERVAL 1 YEAR);
++---------------------------------------------------------+
+| DATE_CEIL('2025-12-31 23:59:59+05:00', INTERVAL 1 YEAR) |
++---------------------------------------------------------+
+| 2027-01-01 00:00:00+08:00                               |
++---------------------------------------------------------+
 
 -- 超过最大年数
 mysql> select date_ceil("9999-07-13",interval 5 year);
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-floor.md
index e9cc5379aed99..1039e0a60e4ef 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-floor.md
@@ -30,17 +30,19 @@ $type$ 代表的是周期单位
 
 | 参数 | 说明 |
 | -- | -- |
-| `date_or_time_expr` | 参数是合法的日期表达式，类型为 为 datetime 或者 date 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)) |
+| `date_or_time_expr` | 参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `period` | 参数是指定每个周期有多少个单位组成,为 `INT` 类型，开始的时间起点为 0001-01-01T00:00:00 |
 | `type` | 参数可以是：YEAR, MONTH, WEEK,DAY, HOUR, MINUTE, SECOND |
 
 ## 返回值
 
-返回一个日期按照 period 周期向下取整的结果，类型和 datetime 保持一致
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE。返回一个日期按照 period 周期向下取整的结果，类型和 `<date_or_time_expr>` 保持一致。
 
 返回与 datetime 类型一致的取整结果：
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 DATE_FLOOR 计算操作。
 - 输入 DATE 类型时，返回 DATE（仅日期部分）；
 - 输入 DATETIME 类型时，返回 DATETIME（包含日期和时间）。
+- 输出 TIMESTAMPTZ 类型，返回 TIMESTAMPTZ（包含日期、时间和偏移量）。
 - 输入带有 scale 的日期时间，返回值也会带有 scale， 小数部分为 0 。
 
 特殊情况：
@@ -82,6 +84,18 @@ mysql> select date_floor("2023-07-13", INTERVAL 5 YEAR);
 | 2021-01-01 00:00:00                       |
 +-------------------------------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 DATE_FLOOR 操作
+SELECT DATE_FLOOR('2025-12-31 23:59:59+05:00', INTERVAL 1 YEAR);
++----------------------------------------------------------+
+| DATE_FLOOR('2025-12-31 23:59:59+05:00', INTERVAL 1 YEAR) |
++----------------------------------------------------------+
+| 2026-01-01 00:00:00+08:00                                |
++----------------------------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT DATE_FLOOR('2025-12-31 23:59:59+05:00', INTERVAL 1 HOUR, '2025-12-15 00:00:00.123') AS result;
+
 -- period 为负数，无效返回错误
 mysql> select date_floor("2023-07-13 22:28:18", INTERVAL -5 MINUTE);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation minute_floor of 2023-07-13 22:28:18, -5, 0001-01-01 00:00:00 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-trunc.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-trunc.md
index e00b609e1e51e..d69a2575f6a15 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-trunc.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-trunc.md
@@ -8,7 +8,7 @@
 
 ## 描述
 
-DATE_TRUNC 函数用于将日期或时间值（datetime）按照指定的时间单位（time_unit）截断，即保留指定单位及更高层级的时间信息，将更低层级的时间信息清至最小日期时间。例如，按 “小时” 截断时，会保留年、月、日、小时，将分钟、秒等清零，按照年截断时，会把日，月截断为 xxxx-01-01。
+DATE_TRUNC 函数用于将日期或时间值按照指定的时间单位（time_unit）截断，即保留指定单位及更高层级的时间信息，将更低层级的时间信息清至最小日期时间。例如，按 “小时” 截断时，会保留年、月、日、小时，将分钟、秒等清零，按照年截断时，会把日，月截断为 xxxx-01-01。支持输入类型为 TIMESTAMPTZ, DATETIME, DATE。
 
 该函数与 postgresql 中的 [date_trunc函数](https://www.postgresql.org/docs/16/functions-datetime.html#FUNCTIONS-DATETIME-TRUNC) 行为基本一致, 不同的是, doris暂不支持 second 单位以下的截断, postgresql 支持到 microsecond 。
 
@@ -23,14 +23,13 @@ DATE_TRUNC(<time_unit>, <datetime>)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_part>` | 合法的日期表达式, 类型为 datetime 或者 date 类型, 具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)) |
+| `<date_or_time_part>` | 合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<time_unit>` | 希望截断的时间间隔，可选的值如下：[`second`,`minute`,`hour`,`day`,`week`,`month`,`quarter`,`year`] |
 
 ## 返回值
 
-返回与 datetime 类型一致的截断结果：
-- 输入 DATE 时，返回 DATE 类型；
-- 输入 DATETIME 或带时间的字符串时，返回 DATETIME（包含日期和截断后的时间）。
+返回类型与`<date_or_time_part>`类型保持一致， 返回对应的日期时间类型截断之后的结果（即保留指定单位及更高层级的时间信息，将更低层级的时间信息清至最小日期时间）
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`)，再进行截断操作。
 - 对于带有 scale 的 datetime 类型，会截小数为零但保留 scale 返回.
 
 特殊情况：
@@ -106,6 +105,15 @@ mysql> select date_trunc('2010-12-02 19:28:30.523', 'second');
 | 2010-12-02 19:28:30.000                         |
 +-------------------------------------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 DATE_TRUNC 截断操作
+SELECT DATE_TRUNC('2025-12-31 23:59:59+05:00', 'year');
++-------------------------------------------------+
+| DATE_TRUNC('2025-12-31 23:59:59+05:00', 'year') |
++-------------------------------------------------+
+| 2026-01-01 00:00:00+08:00                       |
++-------------------------------------------------+
+
 ---不支持的单位，返回错误
 select date_trunc('2010-12-02 19:28:30', 'quar');
 ERROR 1105 (HY000): errCode = 2, detailMessage = date_trunc function time unit param only support argument is year|quarter|month|week|day|hour|minute|second
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/day-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/day-ceil.md
index b0f73cf305c26..c2d8d53ad33b0 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/day-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/day-ceil.md
@@ -33,17 +33,18 @@ DAY_CEIL(<date_or_time_expr>, <period>, <origin>)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 参数是指定每个周期包含的天数，类型为 INT。若未指定，默认周期为 1 天。 |
 | `<origin>` | 参数是周期计算的起始基准时间，支持 date/datetime 类型|
 
 ## 返回值
 
-返回的是一个日期或时间值，表示将输入值向上舍入到指定天数周期的结果。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE。返回的是一个日期或时间值，表示将输入值向上舍入到指定天数周期的结果。
 
 若输入有效，返回与 datetime 类型一致的取整结果：
-
-`<date_or_time_expr>` 与 `<origin>` 输入都 DATE 类型时，返回 DATE 类型, 否则返回 DATETIME 类型.
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 DAY_CEIL 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
+- `<date_or_time_expr>` 与 `<origin>` 输入都 DATE 类型时，返回 DATE 类型, 否则返回 DATETIME 类型.
 
 特殊情况：
 
@@ -128,6 +129,23 @@ select day_ceil('2023-07-13 19:30:00.123', 4, '2028-07-14 08:00:00');
 | 2023-07-17 08:00:00.000                                       |
 +---------------------------------------------------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 DAY_CEIL 操作
+SELECT DAY_CEIL('2025-12-31 23:59:59+05:00');
++---------------------------------------+
+| DAY_CEIL('2025-12-31 23:59:59+05:00') |
++---------------------------------------+
+| 2026-01-02 00:00:00+08:00             |
++---------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT DAY_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++------------------------------------------------------------------+
+| DAY_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++------------------------------------------------------------------+
+| 2026-01-02 00:00:00.123                                          |
++------------------------------------------------------------------+
+
 -- 周期为负数
 mysql> select day_ceil("2023-07-13 22:28:18", -2);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation day_ceil of 2023-07-13 22:28:18, -2 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/day-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/day-floor.md
index 358eb4544eae2..a7639bb53c2f0 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/day-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/day-floor.md
@@ -33,17 +33,18 @@ DAY_FLOOR(<date_or_time_expr>, <period>, <origin>)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 参数是指定每个周期包含的天数，类型为 INT。若为负数或 0，返回 错误；若未指定，默认周期为 1 天。 |
 | `<origin>` | 参数是周期计算的起始基准时间，支持 date/datetime 类型。若未指定，默认值为 0001-01-01 00:00:00；若输入无效格式，返回 NULL。 |
 
 ## 返回值
 
-返回的是一个日期或时间值，表示将输入值向下舍入到指定天数周期的结果。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE。返回的是一个日期或时间值,表示将输入值向下舍入到指定天数周期的结果。
 
 若输入有效，返回与 datetime 类型一致的取整结果：
-
-`<date_or_time_expr>` 与 `<origin>` 输入都 DATE 类型时，返回 DATE 类型, 否则返回 DATETIME 类型.
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 DAY_FLOOR 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
+- `<date_or_time_expr>` 与 `<origin>` 输入都 DATE 类型时，返回 DATE 类型, 否则返回 DATETIME 类型.
 
 特殊情况：
 
@@ -119,6 +120,23 @@ select day_floor('2023-07-13 19:30:00.123', 4, '2028-07-14 08:00:00');
 | 2023-07-13 08:00:00.000                                        |
 +----------------------------------------------------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 DAY_FLOOR 操作
+SELECT DAY_FLOOR('2025-12-31 23:59:59+05:00');
++----------------------------------------+
+| DAY_FLOOR('2025-12-31 23:59:59+05:00') |
++----------------------------------------+
+| 2026-01-01 00:00:00+08:00              |
++----------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT DAY_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++-------------------------------------------------------------------+
+| DAY_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++-------------------------------------------------------------------+
+| 2026-01-01 00:00:00.123                                           |
++-------------------------------------------------------------------+
+
 ---周期为负数，返回错误
 select day_floor("2023-07-13 22:28:18", -2);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation day_floor of 2023-07-13 22:28:18, -2 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-ceil.md
index 13cf8e5efbd71..69ce5e8b35ce8 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-ceil.md
@@ -32,14 +32,16 @@ HOUR_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 datetime 和 date 类型，date 类型会转换为一天的 00:00:00 开始,具体 datetime/date 格式请查看  [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 datetime/date/timestamptz 类型，date 类型会转换为一天的 00:00:00 开始,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 可选参数，指定周期长度（单位：小时），为正整数（如 1、3、5）。默认值为 1，表示每 1 小时一个周期|
 | `<origin>` | 开始的时间起点，支持输入 datetime 和 date 类型，如果不填，默认是 0001-01-01T00:00:00 |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示向上取整后的最近周期时刻。
+返回 TIMESTAMPTZ, DATETIME 或 DATE 类型的值，表示向上取整后的最近周期时刻。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 CEIL 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若输入的 period 为非正数，返回错误。
 - 若是任意参数为 NULL ,结果返回 NULL.
 - origin 或 datetime 带有 scale, 返回结果带有 scale, 小数部位变为零
@@ -117,6 +119,23 @@ select hour_ceil('2023-07-13 19:30:00.123', 4, '2028-07-14 08:00:00');
 select hour_ceil("9999-12-31 22:28:18", 6);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation hour_ceil of 9999-12-31 22:28:18, 6 out of range
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 HOUR_CEIL 操作
+SELECT HOUR_CEIL('2025-12-31 23:59:59+05:00');
++----------------------------------------+
+| HOUR_CEIL('2025-12-31 23:59:59+05:00') |
++----------------------------------------+
+| 2026-01-01 03:00:00                    |
++----------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT HOUR_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++-------------------------------------------------------------------+
+| HOUR_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++-------------------------------------------------------------------+
+| 2026-01-01 03:00:00.123                                           |
++-------------------------------------------------------------------+
+
 -- period 小于等于 0.返回错误
 mysql> select hour_ceil("2023-07-13 22:28:18", 0);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation hour_ceil of 2023-07-13 22:28:18, 0 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-floor.md
index e4abc598e54e3..d824d0deff259 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-floor.md
@@ -33,14 +33,16 @@ HOUR_FLOOR(`<date_or_time_expr>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | -- | -- |
-| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 datetime/date 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体 datetime/date 格式请查看  [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 参数是合法的日期表达式，支持输入 datetime/date/timestamptz 类型,date 类型会转换为对应日期的一天起始时间 00:00:00 ,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 	可选参数，指定周期长度（单位：小时），为正整数（如 2、6、12）。默认值为 1，表示每 1 小时一个周期。|
 |` <origin>` | 开始的时间起点，支持输入 datetime/date 类型，如果不填，默认是 0001-01-01T00:00:00 |
 
 ## 返回值
 
-返回 DATETIME 类型的值，表示向下取整后的最近周期时刻。
+返回 TIMESTAMPTZ, DATETIME 或 DATE 类型的值，表示向下取整后的最近周期时刻。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 FLOOR 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若输入的 period 为非正数，返回错误。
 - 若是任意参数为 NULL ,结果返回 NULL.
 - origin 或 datetime 带有 scale,返回结果带有 scale，小数部分变为零
@@ -113,6 +115,23 @@ select hour_floor('2023-07-13 19:30:00.123', 4, '2028-07-14 08:00:00');
 | 2023-07-13 16:00:00.000                                         |
 +-----------------------------------------------------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 HOUR_FLOOR 操作
+SELECT HOUR_FLOOR('2025-12-31 23:59:59+05:00');
++-----------------------------------------+
+| HOUR_FLOOR('2025-12-31 23:59:59+05:00') |
++-----------------------------------------+
+| 2026-01-01 02:00:00                     |
++-----------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT HOUR_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++--------------------------------------------------------------------+
+| HOUR_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++--------------------------------------------------------------------+
+| 2026-01-01 02:00:00.123                                            |
++--------------------------------------------------------------------+
+
 -- 输入任一参数为 NULL（返回NULL）
 mysql> select hour_floor(null, 6) as null_input;
 +------------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minute-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minute-ceil.md
index 047fff6806f9b..173d5ef7209a1 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minute-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minute-ceil.md
@@ -33,14 +33,16 @@ MINUTE_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 需要向上取整的日期时间值，类型为 DATETIME，具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) |
+| `<date_or_time_expr>` | 需要向上取整的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 分钟周期值，类型为 INT，表示每个周期包含的分钟数 |
 | `<origin>` | 周期的起始时间点，类型为 DATETIME ，默认值为 0001-01-01 00:00:00 |
 
 ## 返回值
 
-返回类型为 DATETIME，返回以输入日期时间为基准，向上取整到最近的指定分钟周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE。返回以输入日期时间为基准，向上取整到最近的指定分钟周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 MINUTE_CEIL 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正数（≤0），返回错误 。
 - 若任一参数为 NULL，返回 NULL
 - 不指定 period 时，默认以 1 分钟为周期
@@ -122,6 +124,23 @@ SELECT MINUTE_CEIL('0001-01-01 12:32:18', 5, '2028-07-03 22:20:00') AS result;
 select minute_ceil("9999-12-31 23:59:18", 6);
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation minute_ceil of 9999-12-31 23:59:18, 6 out of range
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 MINUTE_CEIL 操作
+SELECT MINUTE_CEIL('2025-12-31 23:59:59+05:00');
++------------------------------------------+
+| MINUTE_CEIL('2025-12-31 23:59:59+05:00') |
++------------------------------------------+
+| 2026-01-01 03:00:00+08:00                |
++------------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT MINUTE_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++---------------------------------------------------------------------+
+| MINUTE_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++---------------------------------------------------------------------+
+| 2026-01-01 03:00:00.123                                             |
++---------------------------------------------------------------------+
+
 -- 周期为非正数，返回错误
 SELECT MINUTE_CEIL('2023-07-13 22:28:18', -5) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation minute_ceil of 2023-07-13 22:28:18, -5 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minute-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minute-floor.md
index 31a633c0601bf..01f9ae78ce47e 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minute-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minute-floor.md
@@ -34,15 +34,17 @@ MINUTE_FLOOR(`<datetime>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<datetime>` | 需要向下取整的日期时间值，类型为 DATETIME ，具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)) |
+| `<datetime>` | 需要向下取整的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 分钟周期值，类型为 INT，表示每个周期包含的分钟数 |
 | `<origin>` | 周期的起始时间点，类型为 DATETIME ，默认值为 0001-01-01 00:00:00 |
 
 ## 返回值
 
 
-返回类型为 DATETIME，返回以输入日期时间为基准，向下取整到最近的指定分钟周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE。返回以输入日期时间为基准，向下取整到最近的指定分钟周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 MINUTE_FLOOR 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正（≤0），返回错误。
 - 若任一参数为 NULL，返回 NULL。
 - 不指定 period 时，默认以 1 分钟为周期。
@@ -118,6 +120,23 @@ SELECT MINUTE_FLOOR('2023-07-13', 30) AS result;
 | 2023-07-13 00:00:00 |
 +---------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 MINUTE_FLOOR 操作
+SELECT MINUTE_FLOOR('2025-12-31 23:59:59+05:00');
++-------------------------------------------+
+| MINUTE_FLOOR('2025-12-31 23:59:59+05:00') |
++-------------------------------------------+
+| 2026-01-01 02:59:00+08:00                 |
++-------------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT MINUTE_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++----------------------------------------------------------------------+
+| MINUTE_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++----------------------------------------------------------------------+
+| 2026-01-01 02:59:00.123                                              |
++----------------------------------------------------------------------+
+
 --- 周期为非正数，返回 错误
 SELECT MINUTE_FLOOR('2023-07-13 22:28:18', -5) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation minute_floor of 2023-07-13 22:28:18, -5 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-ceil.md
index 7a0ce7c9805db..552ea0e4a1a97 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-ceil.md
@@ -33,14 +33,16 @@ MONTH_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 需要向上取整的日期时间值，参数是合法的日期表达式，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 需要向上取整的日期时间值，参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 月份周期值，类型为 INT，表示每个周期包含的月数 |
 | `<origin>` | 周期的起始时间点，支持输入 date/datetime 类型，默认值为 0001-01-01 00:00:00 |
 
 ## 返回值
 
-返回类型为 DATETIME，返回以输入日期时间为基准，向上取整到最近的指定月份周期后的时间值。结果的时间部分将被设置为 00:00:00,日部分会截断为 01。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE，返回以输入日期时间为基准，向上取整到最近的指定月份周期后的时间值。结果的时间部分将被设置为 00:00:00,日部分会截断为 01。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 CEIL 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正，返回错误。
 - 若任一参数为 NULL，返回 NULL。
 - 不指定 period 时，默认以 1 个月为周期。
@@ -117,6 +119,23 @@ SELECT MONTH_CEIL('2023-07-13', 3) AS result;
 | 2023-10-01 00:00:00 |
 +---------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 CEIL 操作
+SELECT MONTH_CEIL('2025-12-31 23:59:59+05:00');
++-----------------------------------------+
+| MONTH_CEIL('2025-12-31 23:59:59+05:00') |
++-----------------------------------------+
+| 2026-02-01 00:00:00+08:00               |
++-----------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT MONTH_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++--------------------------------------------------------------------+
+| MONTH_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++--------------------------------------------------------------------+
+| 2026-01-15 00:00:00.123                                            |
++--------------------------------------------------------------------+
+
 -- 计算结果超过日期最大范围 9999-12-31，结果返回错误
 SELECT MONTH_CEIL('9999-12-13 22:28:18',5) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation month_ceil of 9999-12-13 22:28:18, 5 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-floor.md
index 2dc9fec901c7a..8ca2f77f81840 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-floor.md
@@ -34,17 +34,19 @@ MINUTE_FLOOR(`<date_or_time_expr>, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 需要向下取整的日期时间值，类型为 DATETIME 或 DATE ，具体 datetime/date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | 需要向下取整的日期时间值，类型为 DATETIME 或 DATE ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<period>` | 月份周期值，类型为 INT，表示每个周期包含的月数 |
 | `<origin>` | 周期的起始时间点，类型为 DATETIME/DATE ，默认值为 0001-01-01 00:00:00 |
 
 ## 返回值
 
-返回类型为 DATETIME，返回以输入日期时间为基准，向下取整到最近的指定分钟周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE，返回以输入日期时间为基准，向下取整到最近的指定月份周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 FLOOR 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正（≤0），返回错误。
 - 若任一参数为 NULL，返回 NULL。
-- 不指定 period 时，默认以 1 分钟为周期。
+- 不指定 period 时，默认以 1 个月份为周期。
 - `<origin>` 未指定，默认以 0001-01-01 00:00:00 为基准。
 - 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00。
 - 若 `<origin>` 日期时间在 `<period>` 之后，也会按照上述公式计算，不过周期 k 为负数。
@@ -110,22 +112,39 @@ SELECT MONTH_FLOOR('2022-09-13 22:28:18', 5, '2028-07-03 22:20:00') AS result;
 +---------------------+
 
 --- 输入为 DATE 类型（默认时间 00:00:00）
-SELECT MINUTE_FLOOR('2023-07-13', 30) AS result;
+SELECT MONTH_FLOOR('2023-07-13', 30) AS result;
 +---------------------+
 | result              |
 +---------------------+
 | 2023-07-13 00:00:00 |
 +---------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 FLOOR 操作
+SELECT MONTH_FLOOR('2025-12-31 23:59:59+05:00');
++------------------------------------------+
+| MONTH_FLOOR('2025-12-31 23:59:59+05:00') |
++------------------------------------------+
+| 2026-01-01 00:00:00+08:00                |
++------------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT MONTH_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++---------------------------------------------------------------------+
+| MONTH_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++---------------------------------------------------------------------+
+| 2025-12-15 00:00:00.123                                             |
++---------------------------------------------------------------------+
+
 --- 周期为非正数，返回错误
-SELECT MINUTE_FLOOR('2023-07-13 22:28:18', -5) AS result;
-ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation minute_floor of 2023-07-13 22:28:18, -5 out of range
+SELECT MONTH_FLOOR('2023-07-13 22:28:18', -5) AS result;
+ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation month_floor of 2023-07-13 22:28:18, -5 out of range
 
 --- 任一参数为 NULL，返回 NULL
-SELECT MINUTE_FLOOR(NULL, 5), MINUTE_FLOOR('2023-07-13 22:28:18', NULL) AS result;
-+------------------------+--------+
-| minute_floor(NULL, 5)  | result |
-+------------------------+--------+
-| NULL                   | NULL   |
-+------------------------+--------+
+SELECT MONTH_FLOOR(NULL, 5), MONTH_FLOOR('2023-07-13 22:28:18', NULL) AS result;
++-----------------------+--------+
+| month_floor(NULL, 5)  | result |
++-----------------------+--------+
+| NULL                  | NULL   |
++-----------------------+--------+
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarter-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarter-ceil.md
index a51cffdb3aac2..fe2548ebf16a5 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarter-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarter-ceil.md
@@ -33,14 +33,16 @@ QUARTER_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 需要向上取整的日期时间值，参数是合法的日期表达式，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 需要向上取整的日期时间值，参数是合法的日期表达式，支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 季度周期值，类型为 INT，表示每个周期包含的季度数 |
 | `<origin>` | 周期的起始时间点，支持输入 date/datetime 类型，默认值为 0001-01-01 00:00:00 |
 
 ## 返回值
 
-返回类型为 DATETIME，返回以输入日期时间为基准，向上取整到最近的指定季度周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE，返回以输入日期时间为基准，向上取整到最近的指定季度周期后的时间值。返回值的精度与输入参数的精度相同。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 CEIL 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正，返回错误。
 - 若任一参数为 NULL，返回 NULL。
 - 不指定 period 时，默认以 1 个季度为周期。
@@ -132,6 +134,23 @@ SELECT QUARTER_CEIL(NULL, 1), QUARTER_CEIL('2023-07-13 22:28:18', NULL) AS resul
 +-----------------------+--------+
 | NULL                  | NULL   |
 +-----------------------+--------+
+
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 CEIL 操作
+SELECT QUARTER_CEIL('2025-12-31 23:59:59+05:00');
++-------------------------------------------+
+| QUARTER_CEIL('2025-12-31 23:59:59+05:00') |
++-------------------------------------------+
+| 2026-04-01 00:00:00+08:00                 |
++-------------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT QUARTER_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++----------------------------------------------------------------------+
+| QUARTER_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++----------------------------------------------------------------------+
+| 2026-03-15 00:00:00.123                                              |
++----------------------------------------------------------------------+
 ```
 
 ## 最佳实践
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarter-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarter-floor.md
index 5eb3c29117a69..39ca4ff19d87a 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarter-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/quarter-floor.md
@@ -34,14 +34,16 @@ QUARTER_FLOOR(`<date_or_time_expr>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 需要向下取整的日期时间值，类型为 DATETIME 或 DATE ，具体 datetime/date 格式请查看 [datetime 的转换](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | 需要向下取整的日期时间值，类型为 DATETIME 或 DATE ，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
 | `<period>` | 季度周期值，类型为 INT，表示每个周期包含的季度数 |
 | `<origin_datetime>` | 周期的起始时间点，类型为 DATETIME/DATE ，默认值为 0001-01-01 00:00:00 |
 
 ## 返回值
 
-返回类型为 DATETIME，返回以输入日期时间为基准，向下取整到最近的指定季度周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE，返回以输入日期时间为基准，向下取整到最近的指定季度周期后的时间值。返回值的精度与输入参数的精度相同。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 FLOOR 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正（≤0），返回错误。
 - 若任一参数为 NULL，返回 NULL。
 - 不指定 period 时，默认以 1 个季度为周期。
@@ -128,6 +130,23 @@ SELECT QUARTER_FLOOR(NULL, 1), QUARTER_FLOOR('2023-07-13 22:28:18', NULL) AS res
 +------------------------+--------+
 | NULL                   | NULL   |
 +------------------------+--------+
+
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 FLOOR 操作
+SELECT QUARTER_FLOOR('2025-12-31 23:59:59+05:00');
++--------------------------------------------+
+| QUARTER_FLOOR('2025-12-31 23:59:59+05:00') |
++--------------------------------------------+
+| 2026-01-01 00:00:00+08:00                  |
++--------------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT QUARTER_FLOOR('2025-12-31 23:59:59+05:00', '2022-12-15 00:00:00.123');
++-----------------------------------------------------------------------+
+| QUARTER_FLOOR('2025-12-31 23:59:59+05:00', '2022-12-15 00:00:00.123') |
++-----------------------------------------------------------------------+
+| 2025-12-15 00:00:00.123                                               |
++-----------------------------------------------------------------------+
 ```
 
 ## 最佳实践
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
index f144ebd0f0d39..866f3021bc687 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
@@ -29,14 +29,16 @@ SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 
 | 参数                  | 说明                                                       |
 |---------------------|----------------------------------------------------------|
-| `<datetime>`        | 必填，输入的日期时间值，支持输入 datetime 类型,具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)                            |
+| `<datetime>`        | 必填，输入的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                            |
 | `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                   |
 | `<origin_datetime>` | 可选，对齐的时间起点，支持输入 datetime 类型和符合日期时间格式的字符串。如果未指定，默认为 0001-01-01T00:00:00。 |
 
 ## 返回值
 
-返回类型为 DATETIME，返回以输入日期时间为基准，向上取整到最近的指定秒周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE。返回以输入日期时间为基准，向上取整到最近的指定秒周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 SECOND_CEIL 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正数（≤0），返回错误。
 - 若任一参数为 NULL，返回 NULL。
 - 不指定 period 时，默认以 1 秒为周期。
@@ -109,6 +111,23 @@ SELECT SECOND_CEIL('2025-01-23', 30) AS result;
 SELECT SECOND_CEIL('9999-12-31 23:59:59', 2) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation second_ceil of 9999-12-31 23:59:59, 2 out of range
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 SECOND_CEIL 操作
+SELECT SECOND_CEIL('2025-12-31 23:59:59+05:00');
++------------------------------------------+
+| SECOND_CEIL('2025-12-31 23:59:59+05:00') |
++------------------------------------------+
+| 2026-01-01 02:59:59+08:00                |
++------------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT SECOND_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++---------------------------------------------------------------------+
+| SECOND_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++---------------------------------------------------------------------+
+| 2026-01-01 02:59:59.123                                             |
++---------------------------------------------------------------------+
+
 --- 周期为非正数，返回错误
 mysql> SELECT SECOND_CEIL('2025-01-23 12:34:56', -3) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation second_ceil of 2025-01-23 12:34:56, -3 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
index 61c9d6fc5a4b1..c68fe861a795b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
@@ -30,13 +30,15 @@ SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 
 | 参数                  | 说明                                                       |
 |---------------------|----------------------------------------------------------|
-| `<datetime>`        | 必填，输入的日期时间值，支持输入 datetime 类型,具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)                            |
+| `<datetime>`        | 必填，输入的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                            |
 | `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
 | `<origin_datetime>` | 可选，对齐的时间起点，支持输入 datetime 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
 ## 返回值
-返回类型为 DATETIME，返回以输入日期时间为基准，向下取整到最近的指定秒周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE。返回以输入日期时间为基准，向下取整到最近的指定秒周期后的时间值。返回值的精度与输入参数 datetime 的精度相同。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 SECOND_FLOOR 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正数（≤0），返回错误。
 - 若任一参数为 NULL，返回 NULL。
 - 不指定 period 时，默认以 1 秒为周期。
@@ -104,6 +106,23 @@ SELECT SECOND_FLOOR('2025-01-23', 30) AS result;
 | 2025-01-23 00:00:00 |
 +---------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 SECOND_FLOOR 操作
+SELECT SECOND_FLOOR('2025-12-31 23:59:59+05:00');
++-------------------------------------------+
+| SECOND_FLOOR('2025-12-31 23:59:59+05:00') |
++-------------------------------------------+
+| 2026-01-01 02:59:59+08:00                 |
++-------------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT SECOND_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++----------------------------------------------------------------------+
+| SECOND_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++----------------------------------------------------------------------+
+| 2026-01-01 02:59:58.123                                              |
++----------------------------------------------------------------------+
+
 --- 周期为非正数，返回错误
 SELECT SECOND_FLOOR('2025-01-23 12:34:56', -3) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation second_floor of 2025-01-23 12:34:56, -3 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/to-iso8601.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/to-iso8601.md
index 771c5c5011035..d74ff3f6bafbe 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/to-iso8601.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/to-iso8601.md
@@ -2,14 +2,13 @@
 {
     "title": "TO_ISO8601",
     "language": "zh-CN",
-    "description": "将日期时间值转换为 ISO8601 格式的字符串,支持输入类型为 DATETIME ,DATE . 返回的的 ISO8601 格式的日期时间表示为 YYYY-MM-DDTHH:MM:SS，T是日期和时间的分隔符"
+    "description": "将日期时间值转换为 ISO8601 格式的字符串,支持输入类型为 TIMESTAMPTZ, DATETIME, DATE."
 }
 ---
 
 ## 描述
 
-将日期时间值转换为 ISO8601 格式的字符串,支持输入类型为 DATETIME ,DATE .
-返回的的 ISO8601 格式的日期时间表示为 YYYY-MM-DDTHH:MM:SS，T是日期和时间的分隔符
+将日期时间值转换为 ISO8601 格式的字符串,支持输入类型为 TIMESTAMPTZ, DATETIME, DATE.
 
 ## 语法
 
@@ -20,14 +19,15 @@ TO_ISO8601(<date_or_time_expr>)
 ## 参数
 | 参数                         | 描述                          |
 |----------------------------|-----------------------------|
-| `<date_or_time_expr>` | 输入的日期时间值，支持输入 date/datetime 类型，具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 输入的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 
 ## 返回值
 
 返回类型为 VARCHAR，表示 ISO8601 格式的日期时间字符串。
 
 - 若输入为 DATE （如 '2023-10-05'），返回格式为 YYYY-MM-DD（仅日期）；
-- 若输入为 DATETIME （如 '2023-10-05 15:30:25'），返回格式为 YYYY-MM-DDTHH:MM:SS.xxxxxx（日期与时间用 T 分隔,xxxxxx 全为零，输入的 datetime 的小数全部四舍五入为秒）；
+- 若输入为 DATETIME （如 '2023-10-05 15:30:25'），返回格式为 YYYY-MM-DDTHH:MM:SS.ssssss；
+- 若输入为 TIMESTAMPTZ（如 '2023-10-05 15:30:25+03:00'）返回格式为 YYYY-MM-DDTHH:MM:SS.ssssss±HH:MM（时区偏移信息由会话变量中的`time_zone`决定）；
 - 若输入为 NULL，返回 NULL；
 
 ## 举例
@@ -42,7 +42,7 @@ SELECT TO_ISO8601(CAST('2023-10-05' AS DATE)) AS date_result;
 +--------------+
 
 --  转换 DATETIME 类型（带时分秒）
-SELECT TO_ISO8601(CAST('2020-01-01 12:30:45' AS DATETIME)) AS datetime_result;
+SELECT TO_ISO8601('2020-01-01 12:30:45') AS datetime_result;
 +----------------------------+
 | datetime_result            |
 +----------------------------+
@@ -50,13 +50,21 @@ SELECT TO_ISO8601(CAST('2020-01-01 12:30:45' AS DATETIME)) AS datetime_result;
 +----------------------------+
 
 ---输入带有 scale ,四舍五入为秒
-SELECT TO_ISO8601(CAST('2020-01-01 12:30:45.956' AS DATETIME)) AS datetime_result;
+SELECT TO_ISO8601('2020-01-01 12:30:45.956') AS datetime_result;
 +----------------------------+
 | datetime_result            |
 +----------------------------+
-| 2020-01-01T12:30:46.000000 |
+| 2020-01-01T12:30:45.956000 |
 +----------------------------+
 
+-- 输入类型为 TimeStampTz
+SELECT TO_ISO8601('2025-10-10 11:22:33+03:00');
++-----------------------------------------+
+| TO_ISO8601('2025-10-10 11:22:33+03:00') |
++-----------------------------------------+
+| 2025-10-10T16:22:33.000000+08:00        |
++-----------------------------------------+
+
 -- 输入为 NULL（返回 NULL）
 SELECT TO_ISO8601(NULL) AS null_input;
 +------------+
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/week-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/week-ceil.md
index 97a7d893470bb..216725ce3f769 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/week-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/week-ceil.md
@@ -33,14 +33,16 @@ WEEK_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 要向上舍入的日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
+| `<date_or_time_expr>` | 要向上舍入的日期时间值，支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 周间隔值，类型为 INT，表示每个间隔的周数 |
 | `<origin>` | 间隔的起始点，支持输入 date/datetime 类型；默认为 0000-01-01 00:00:00 |
 
 ## 返回值
 
-返回类型为 DATETIME，表示向上舍入后的日期时间值。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE，表示向上舍入后的日期时间值。
 
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 CEIL 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正数（≤0），函数返回错误；
 - 若任一参数为 NULL，返回 NULL；
 - 若 `<date_or_time_expr>` 恰好是某间隔的起始点（基于 `<period>` 和 `<origin>`），则返回该起始点；
@@ -118,6 +120,23 @@ SELECT WEEK_CEIL('2023-07-10', 1, '2023-07-10 12:00:00') AS result;
 | 2023-07-10 12:00:00 |
 +---------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 WEEK_CEIL 操作
+SELECT WEEK_CEIL('2025-12-31 23:59:59+05:00');
++----------------------------------------+
+| WEEK_CEIL('2025-12-31 23:59:59+05:00') |
++----------------------------------------+
+| 2026-01-05 00:00:00+08:00              |
++----------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT WEEK_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++-------------------------------------------------------------------+
+| WEEK_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++-------------------------------------------------------------------+
+| 2026-01-05 00:00:00.123                                           |
++-------------------------------------------------------------------+
+
 ---计算结果超过最大日期时间 9999-12-31 23:59:59 ，则返回错误 。
 SELECT WEEK_CEIL('9999-12-31 22:28:18', 2) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation week_ceil of 9999-12-31 22:28:18, 2 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/week-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/week-floor.md
index 7d137779a6c51..3a7494d88cc3f 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/week-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/week-floor.md
@@ -35,13 +35,16 @@ WEEK_FLOOR(`<date_or_time_expr>`, `<period>`, `<origin>`)
 
 | 参数 | 说明 |
 | ---- | ---- |
-| `<date_or_time_expr>` | 要向下舍入的日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| `<date_or_time_expr>` | 要向下舍入的日期时间值，支持输入 date/datetime/timestamptz 类型，具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
 | `<period>` | 周间隔值，类型为 INT，表示每个间隔的周数 |
 | `<origin>` | 间隔的起始点，支持输入 date/datetime 类型；默认为 0000-01-01 00:00:00 |
 
 ## 返回值
 
-返回类型为 DATETIME，表示向下舍入后的日期时间值。结果的时间部分将被设置为 00:00:00。
+返回类型为 TIMESTAMPTZ, DATETIME 或 DATE，表示向下舍入后的日期时间值。
+
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 FLOOR 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。结果的时间部分将被设置为 00:00:00。
 
 - 若 `<period>` 为非正数（≤0），函数返回错误；
 - 若任一参数为 NULL，返回 NULL；
@@ -126,6 +129,23 @@ SELECT WEEK_FLOOR('2023-07-10', 1, '2023-07-10 12:00:00') AS result;
 | 2023-07-03 12:00:00 |
 +---------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 WEEK_FLOOR 操作
+SELECT WEEK_FLOOR('2025-12-31 23:59:59+05:00');
++-----------------------------------------+
+| WEEK_FLOOR('2025-12-31 23:59:59+05:00') |
++-----------------------------------------+
+| 2025-12-29 00:00:00+08:00               |
++-----------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT WEEK_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++--------------------------------------------------------------------+
+| WEEK_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++--------------------------------------------------------------------+
+| 2025-12-29 00:00:00.123                                            |
++--------------------------------------------------------------------+
+
 -- 无效period，返回错误
 SELECT WEEK_FLOOR('2023-07-13', 0) AS result;
 RROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation week_floor of 2023-07-13 00:00:00, 0 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-ceil.md
index 069f8c662aaf3..8cf5521052c76 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-ceil.md
@@ -32,16 +32,18 @@ YEAR_CEIL(<date_or_time_expr>, <period>, <origin>)
 
 | 参数                  | 说明                                                       |
 |---------------------|----------------------------------------------------------|
-| `<date_or_time_expr>`       | 要向上舍入的日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                              |
+| `<date_or_time_expr>`       | 要向上舍入的日期时间值，支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                              |
 | `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
 | `<origin_datetime>` | 间隔的起始点，支持输入 date/datetime 类型；默认为 0000-01-01 00:00:00。 |
 
 
 ## 返回值
 
-返回与输入类型一致的结果（DATETIME 或 DATE），表示向上舍入后的年间隔起始时间：
+返回与输入类型一致的结果（TIMESTAMPTZ, DATETIME 或 DATE），表示向上舍入后的年间隔起始时间：
 
 - 若输入为 DATE 类型，返回 DATE 类型（仅包含日期部分）；若输入为 DATETIME 或符合格式的字符串，返回 DATETIME 类型（时间部分与 origin 一致，无 origin 时默认为 00:00:00）。
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 CEIL 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。 
 - 若 `<period>` 为非正数（≤0），函数返回错误。
 - 若任一参数为 NULL，返回 NULL。
 - 若 `<date_or_time_expr>` 恰好是某间隔的起始点（基于 `<period>` 和 `<origin>`），则返回该起始点。
@@ -125,6 +127,23 @@ SELECT YEAR_CEIL('2023-07-13 22:22:56', 1, '2028-01-01 08:30:00') AS result;
 | 2024-01-01 08:30:00 |
 +---------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 CEIL 操作
+SELECT YEAR_CEIL('2025-12-31 23:59:59+05:00');
++----------------------------------------+
+| YEAR_CEIL('2025-12-31 23:59:59+05:00') |
++----------------------------------------+
+| 2027-01-01 00:00:00+08:00              |
++----------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT YEAR_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++-------------------------------------------------------------------+
+| YEAR_CEIL('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++-------------------------------------------------------------------+
+| 2026-12-15 00:00:00.123                                           |
++-------------------------------------------------------------------+
+
 -- 无效period（非正数）
 SELECT YEAR_CEIL('2023-07-13', 0) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation year_ceil of 2023-07-13 00:00:00, 0 out of range
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-floor.md
index 8bad32935bb4f..6fb581d8b40e3 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-floor.md
@@ -30,15 +30,17 @@ YEAR_FLOOR(<date_or_time_expr>, <period>, <origin>)
 ## 参数
 | 参数                  | 说明                                                       |
 |---------------------|----------------------------------------------------------|
-| `<date_or_time_expr>`       | 要向下舍入的日期时间值，支持输入 date/datetime 类型,具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                              |
+| `<date_or_time_expr>`       | 要向下舍入的日期时间值，支持输入 date/datetime/timestamptz 类型,具体格式请查看 [timestamptz的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/timestamptz-conversion), [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)                              |
 | `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
 | `<origin_datetime>` | 间隔的起始点，支持输入 date/datetime 类型；默认为 0000-01-01 00:00:00。 |
 
 
 ## 返回值
-返回与输入类型一致的结果（DATETIME 或 DATE），表示向下舍入后的年间隔起始时间：
+返回与输入类型一致的结果（TIMESTAMPTZ, DATETIME 或 DATE），表示向下舍入后的年间隔起始时间：
 
 - 若输入为 DATE 类型，返回 DATE 类型（仅包含日期部分）；若输入为 DATETIME 或符合格式的字符串，返回 DATETIME 类型（时间部分与 origin 一致，无 origin 时默认为 00:00:00）。
+- 若输入为 TIMESTAMPTZ 类型，则会先将其转换为 local_time(如：`2025-12-31 23:59:59+05:00` 在会话变量为`+08:00`的情况下代表的local_time为`2026-01-01 02:59:59`),再进行 FLOOR 计算操作。
+- 若输入的时间值(`<date_or_time_expr>` 和`<period>`)同时包含 TIMESTAMPTZ 和 DATETIME 类型，则输出 DATETIME 类型。
 - 若 `<period>` 为非正数（≤0），函数返回错误。
 - 若任一参数为 NULL，返回 NULL。
 - 若 `<date_or_time_expr>` 恰好是某间隔的起始点（基于 `<period>` 和 `<origin>`），则返回该起始点。
@@ -152,6 +154,23 @@ SELECT YEAR_FLOOR('2023-07-13 10:00:00', 1, '2020-01-01 08:30:00') AS result;
 | 2023-01-01 08:30:00 |
 +---------------------+
 
+-- TimeStampTz类型样例, SET time_zone = '+08:00'
+-- 将变量值转换为 local_time(2026-01-01 02:59:59)后再做 FLOOR 操作
+SELECT YEAR_FLOOR('2025-12-31 23:59:59+05:00');
++-----------------------------------------+
+| YEAR_FLOOR('2025-12-31 23:59:59+05:00') |
++-----------------------------------------+
+| 2026-01-01 00:00:00+08:00               |
++-----------------------------------------+
+
+-- 若参数同时包含 TimeStampTz 和 Datetime 类型，则输出 DateTime 类型
+SELECT YEAR_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123');
++--------------------------------------------------------------------+
+| YEAR_FLOOR('2025-12-31 23:59:59+05:00', '2025-12-15 00:00:00.123') |
++--------------------------------------------------------------------+
+| 2025-12-15 00:00:00.123                                            |
++--------------------------------------------------------------------+
+
 -- 无效period（非正数）
 SELECT YEAR_FLOOR('2023-07-13', 0) AS result;
 ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation year_floor of 2023-07-13 00:00:00, 0 out of range