[Feature](func) Support function UTC_DATE & UTC_TIME

Author: linrrzqqq

docs/sql-manual/sql-functions/scalar-functions/date-time-functions/utc-date.md

@@ -0,0 +1,35 @@
+---
+{
+    "title": "UTC_DATE",
+    "language": "en"
+}
+---
+
+## Description
+The UTC_DATE function returns the current date in the UTC timezone. This function is not affected by the local timezone and always returns the current date based on the UTC timezone, ensuring date consistency across different timezone scenarios.
+
+This function behaves consistently with the [utc_date function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_utc-date) in MySQL.
+
+## Syntax
+
+```sql
+UTC_DATE()
+```
+
+## Return Value
+Returns the current UTC date, with the type DATE.
+
+According to different usage scenarios, the return type may be of Date type (format: YYYY-MM-DD) or integer type (format: YYYYMMDD).
+## Examples
+
+```sql
+-- Assume the current local time is UTC+8 2025-10-27 10:55:35
+SELECT UTC_DATE(), UTC_DATE() + 0;
+```
+```text
++------------+----------------+
+| UTC_DATE() | UTC_DATE() + 0 |
++------------+----------------+
+| 2025-10-27 |       20251027 |
++------------+----------------+
+```

docs/sql-manual/sql-functions/scalar-functions/date-time-functions/utc-time.md

@@ -0,0 +1,47 @@
+---
+{
+    "title": "UTC_TIME",
+    "language": "en"
+}
+---
+
+## Description
+The UTC_TIME function returns the current time in the UTC timezone. This function is not affected by the local timezone and always returns the current time based on the UTC timezone, ensuring time consistency across different timezone scenarios.
+
+This function behaves consistently with the [utc_time function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_utc-time) in MySQL.
+
+## Syntax
+
+```sql
+UTC_TIME([<`precision`>])
+```
+
+## Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `<precision>` | The precision of the returned time value supports integer types within the range [0, 6]. Only integer type constants are accepted.。 |
+
+## Return Value
+Returns the current UTC time.
+
+According to different usage scenarios, the return type may be TIME type (format: HH:mm:ss) or integer type (indicating the time elapsed since 00:00:00, in microseconds).
+
+## Examples
+
+```sql
+-- Assume the current local time is UTC+8 2025-10-27 14:39:01
+SELECT UTC_TIME(), UTC_TIME() + 1, UTC_TIME(6), UTC_TIME(6) + 1;
+```
+```text
+------------+----------------+-----------------+-----------------+
+| UTC_TIME() | UTC_TIME() + 1 | UTC_TIME(6)     | UTC_TIME(6) + 1 |
++------------+----------------+-----------------+-----------------+
+| 06:39:01   |    23941000001 | 06:39:01.934119 |     23941934120 |
++------------+----------------+-----------------+-----------------+
+```
+
+```sql
+SELECT UTC_TIME(7);
+-- ERROR 1105 (HY000): errCode = 2, detailMessage = scale must be between 0 and 6
+```

docs/sql-manual/sql-functions/scalar-functions/date-time-functions/utc-timestamp.md

@@ -13,20 +13,35 @@ This function behaves consistently with the [utc_timestamp function](https://dev
 ## Syntax
 
 ```sql
-UTC_TIMESTAMP()
+UTC_TIMESTAMP([`<precision>`])
 ```
 
+## Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `<precision>` | The precision of the returned date-time value supports integer types within the range [0, 6]. Only integer type constants are accepted.。 |
+
 ## Return Value
-Returns the current UTC date and time, type DATETIME.
+Returns the current UTC date and time.
+
+Depending on the use case, the return type may be a DATETIME type (format: YYYY-MM-DD HH:mm:ss[.ssssss]) or an integer type (format: YYYYMMDDHHmmss, milliseconds will be automatically discarded during type conversion).
 
 ## Examples
 
 ```sql
--- Current local time is UTC+8 2025-08-14 11:45:42
-SELECT UTC_TIMESTAMP() AS utc_str;
-+---------------------+
-| utc_str             |
-+---------------------+
-| 2025-08-14 03:45:42 |
-+---------------------+
+-- Current local time is UTC+8 2025-10-27 14:43:21
+SELECT UTC_TIMESTAMP(), UTC_TIMESTAMP() + 0, UTC_TIMESTAMP(5), UTC_TIMESTAMP(5) + 0;
+```
+```text
++---------------------+---------------------+---------------------------+----------------------+
+| UTC_TIMESTAMP()     | UTC_TIMESTAMP() + 0 | UTC_TIMESTAMP(5)          | UTC_TIMESTAMP(5) + 0 |
++---------------------+---------------------+---------------------------+----------------------+
+| 2025-10-27 06:43:21 |      20251027064321 | 2025-10-27 06:43:21.88177 |       20251027064321 |
++---------------------+---------------------+---------------------------+----------------------+
+```
+
+```sql
+SELECT UTC_TIMESTAMP(7);
+-- ERROR 1105 (HY000): errCode = 2, detailMessage = scale must be between 0 and 6
 ```

i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/utc-date.md

@@ -0,0 +1,37 @@
+---
+{
+    "title": "UTC_DATE",
+    "language": "zh-CN"
+}
+---
+
+## 描述
+UTC_DATE 函数用于返回当前 UTC 时区的日期。该函数不受本地时区影响，始终返回基于 UTC 时区的当前日期，确保跨时区场景下的日期一致性。
+
+该函数与 mysql 中的 [utc_date 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_utc-date) 行为一致。
+
+## 语法
+
+```sql
+UTC_DATE()
+```
+
+## 返回值
+返回当前 UTC 日期。
+
+根据使用场景的不同，返回类型可能为 Date 类型（格式：YYYY-MM-DD）或整数类型（格式：YYYYMMDD）。
+
+## 举例
+
+```sql
+--- 假设当前地区时间为东八区 2025-10-27 10:55:35
+SELECT UTC_DATE(), UTC_DATE() + 0;
+```
+```text
++------------+----------------+
+| UTC_DATE() | UTC_DATE() + 0 |
++------------+----------------+
+| 2025-10-27 |       20251027 |
++------------+----------------+
+```
+

i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/utc-time.md

@@ -0,0 +1,48 @@
+---
+{
+    "title": "UTC_TIME",
+    "language": "zh-CN"
+}
+---
+
+## 描述
+UTC_TIME 函数用于返回当前 UTC 时区的时间。该函数不受本地时区影响，始终返回基于 UTC 时区的当前时间，确保跨时区场景下的时间一致性。
+
+该函数与 mysql 中的 [utc_time 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_utc-time) 行为一致。
+
+## 语法
+
+```sql
+UTC_TIME([<`precision`>])
+```
+
+## 参数
+
+| 参数                         | 描述                          |
+|----------------------------|-----------------------------|
+| `<precision>` | 返回的时间值的精度，支持[0, 6]范围内的整数类型。仅接受整数类型常量。 |
+
+## 返回值
+
+返回当前 UTC 时间。
+
+根据使用场景的不同，返回类型可能为 TIME 类型（格式：HH:mm:ss）或整数类型（表示从 00:00:00 开始经过的时间值，单位为微秒）。
+
+## 举例
+
+```sql
+--- 假设当前地区时间为东八区 2025-10-27 14:39:01
+SELECT UTC_TIME(), UTC_TIME() + 1, UTC_TIME(6), UTC_TIME(6) + 1;
+```
+```text
+------------+----------------+-----------------+-----------------+
+| UTC_TIME() | UTC_TIME() + 1 | UTC_TIME(6)     | UTC_TIME(6) + 1 |
++------------+----------------+-----------------+-----------------+
+| 06:39:01   |    23941000001 | 06:39:01.934119 |     23941934120 |
++------------+----------------+-----------------+-----------------+
+```
+
+```sql
+SELECT UTC_TIME(7);
+-- ERROR 1105 (HY000): errCode = 2, detailMessage = scale must be between 0 and 6
+```

i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/utc-timestamp.md

@@ -13,22 +13,37 @@ UTC_TIMESTAMP 函数用于返回当前 UTC 时区在所的日期时间。该函
 ## 语法
 
 ```sql
-UTC_TIMESTAMP()
+UTC_TIMESTAMP([`<precision>`])
 ```
 
+## 参数
+
+| 参数                         | 描述                          |
+|----------------------------|-----------------------------|
+| `<precision>` | 返回的时间值的精度，支持[0, 6]范围内的整数类型。仅接受整数类型常量。 |
+
 ## 返回值
-返回当前 UTC 日期时间，类型为 DATETIME.
+返回当前 UTC 日期时间.
+
+根据使用场景的不同，返回类型可能为 DATETIME 类型（格式：YYYY-MM-DD HH:mm:ss[.ssssss]）或整数类型（格式：YYYYMMDDHHmmss, 在类型转换时，会自动丢弃毫秒数）。
+
 
 ## 举例
 
 ```sql
+---当前地区时间为东八区 2025-10-27 14:43:21
+SELECT UTC_TIMESTAMP(), UTC_TIMESTAMP() + 0, UTC_TIMESTAMP(5), UTC_TIMESTAMP(5) + 0;
+```
+```text
++---------------------+---------------------+---------------------------+----------------------+
+| UTC_TIMESTAMP()     | UTC_TIMESTAMP() + 0 | UTC_TIMESTAMP(5)          | UTC_TIMESTAMP(5) + 0 |
++---------------------+---------------------+---------------------------+----------------------+
+| 2025-10-27 06:43:21 |      20251027064321 | 2025-10-27 06:43:21.88177 |       20251027064321 |
++---------------------+---------------------+---------------------------+----------------------+
+```
 
----当前地区时间为东八区 2025-08-14 11：45：42
-SELECT UTC_TIMESTAMP() AS utc_str;
-+---------------------+
-| utc_str             |
-+---------------------+
-| 2025-08-14 03:45:42 |
-+---------------------+
+```sql
+SELECT UTC_TIMESTAMP(7);
+-- ERROR 1105 (HY000): errCode = 2, detailMessage = scale must be between 0 and 6
 ```
 

sidebars.json

@@ -1419,6 +1419,8 @@
                                         "sql-manual/sql-functions/scalar-functions/date-time-functions/to-days",
                                         "sql-manual/sql-functions/scalar-functions/date-time-functions/to-iso8601",
                                         "sql-manual/sql-functions/scalar-functions/date-time-functions/to-monday",
+                                        "sql-manual/sql-functions/scalar-functions/date-time-functions/utc-date",
+                                        "sql-manual/sql-functions/scalar-functions/date-time-functions/utc-time",
                                         "sql-manual/sql-functions/scalar-functions/date-time-functions/utc-timestamp",
                                         "sql-manual/sql-functions/scalar-functions/date-time-functions/unix-timestamp",
                                         "sql-manual/sql-functions/scalar-functions/date-time-functions/week",