From 7d079ef6fe92fbab31181673f78130ce4a93c5f7 Mon Sep 17 00:00:00 2001
From: bingquanzhao <bingquan_zhao@icloud.com>
Date: Fri, 24 Jan 2025 16:16:52 +0800
Subject: [PATCH] Sql function
 second,second_ceil,second_floor,seconds_add,seconds_diff,seconds_sub,sec_to_time,time_to_sec

---
 .../date-time-functions/sec-to-time.md        | 43 ++++++----
 .../date-time-functions/second-ceil.md        | 82 +++++++++++++------
 .../date-time-functions/second-floor.md       | 82 +++++++++++++------
 .../date-time-functions/second.md             | 35 +++++---
 .../date-time-functions/seconds-add.md        | 49 ++++++-----
 .../date-time-functions/seconds-diff.md       | 48 +++++++----
 .../date-time-functions/seconds-sub.md        | 45 ++++++----
 .../date-time-functions/time-to-sec.md        | 43 ++++++----
 .../date-time-functions/sec-to-time.md        | 37 +++++----
 .../date-time-functions/second-ceil.md        | 77 +++++++++++------
 .../date-time-functions/second-floor.md       | 77 +++++++++++------
 .../date-time-functions/second.md             | 39 +++++----
 .../date-time-functions/seconds-add.md        | 38 +++++----
 .../date-time-functions/seconds-diff.md       | 44 ++++++----
 .../date-time-functions/seconds-sub.md        | 38 +++++----
 .../date-time-functions/time-to-sec.md        | 37 +++++----
 .../date-time-functions/sec-to-time.md        | 37 +++++----
 .../date-time-functions/second-ceil.md        | 77 +++++++++++------
 .../date-time-functions/second-floor.md       | 77 +++++++++++------
 .../date-time-functions/second.md             | 36 ++++----
 .../date-time-functions/seconds-add.md        | 38 +++++----
 .../date-time-functions/seconds-diff.md       | 44 ++++++----
 .../date-time-functions/seconds-sub.md        | 38 +++++----
 .../date-time-functions/time-to-sec.md        | 37 +++++----
 .../date-time-functions/sec-to-time.md        | 37 +++++----
 .../date-time-functions/second-ceil.md        | 77 +++++++++++------
 .../date-time-functions/second-floor.md       | 77 +++++++++++------
 .../date-time-functions/second.md             | 39 +++++----
 .../date-time-functions/seconds-add.md        | 38 +++++----
 .../date-time-functions/seconds-diff.md       | 44 ++++++----
 .../date-time-functions/seconds-sub.md        | 38 +++++----
 .../date-time-functions/time-to-sec.md        | 37 +++++----
 .../date-time-functions/sec-to-time.md        | 37 +++++----
 .../date-time-functions/second-ceil.md        | 77 +++++++++++------
 .../date-time-functions/second-floor.md       | 77 +++++++++++------
 .../date-time-functions/second.md             | 39 +++++----
 .../date-time-functions/seconds-add.md        | 38 +++++----
 .../date-time-functions/seconds-diff.md       | 44 ++++++----
 .../date-time-functions/seconds-sub.md        | 38 +++++----
 .../date-time-functions/time-to-sec.md        | 37 +++++----
 .../date-time-functions/sec-to-time.md        | 43 ++++++----
 .../date-time-functions/second-ceil.md        | 82 +++++++++++++------
 .../date-time-functions/second-floor.md       | 82 +++++++++++++------
 .../date-time-functions/second.md             | 40 +++++----
 .../date-time-functions/seconds-add.md        | 45 ++++++----
 .../date-time-functions/seconds-diff.md       | 48 +++++++----
 .../date-time-functions/seconds-sub.md        | 45 ++++++----
 .../date-time-functions/time-to-sec.md        | 43 ++++++----
 .../date-time-functions/sec-to-time.md        | 43 ++++++----
 .../date-time-functions/second-ceil.md        | 82 +++++++++++++------
 .../date-time-functions/second-floor.md       | 82 +++++++++++++------
 .../date-time-functions/second.md             | 35 +++++---
 .../date-time-functions/seconds-add.md        | 45 ++++++----
 .../date-time-functions/seconds-diff.md       | 48 +++++++----
 .../date-time-functions/seconds-sub.md        | 45 ++++++----
 .../date-time-functions/time-to-sec.md        | 43 ++++++----
 .../date-time-functions/sec-to-time.md        | 43 ++++++----
 .../date-time-functions/second-ceil.md        | 82 +++++++++++++------
 .../date-time-functions/second-floor.md       | 82 +++++++++++++------
 .../date-time-functions/second.md             | 35 +++++---
 .../date-time-functions/seconds-add.md        | 45 ++++++----
 .../date-time-functions/seconds-diff.md       | 48 +++++++----
 .../date-time-functions/seconds-sub.md        | 45 ++++++----
 .../date-time-functions/time-to-sec.md        | 43 ++++++----
 64 files changed, 2095 insertions(+), 1151 deletions(-)

diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
index c83764cb856fb..375012a2ca75c 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## sec_to_time
-### description
-#### Syntax
+## Description
+The `SEC_TO_TIME` function converts a value in seconds into a `TIME` type, returning the result in the format `HH:MM:SS`.  
+The input seconds represent the time elapsed since the start of a day (`00:00:00`).
 
-`TIME sec_to_time(INT timestamp)`
 
-The parameter is a timestamp of type INT, and the function returns a time of type TIME.
+## Syntax
 
-### example
-
-```
-mysql >select sec_to_time(time_to_sec(cast('16:32:18' as time)));
-+----------------------------------------------------+
-| sec_to_time(time_to_sec(CAST('16:32:18' AS TIME))) |
-+----------------------------------------------------+
-| 16:32:18                                           |
-+----------------------------------------------------+
-1 row in set (0.53 sec)
+```sql
+SEC_TO_TIME(<seconds>)
 ```
+## Parameters
+
+| Parameter     | Description                                                                                                                                           |
+|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<seconds>` | Required. The input number of seconds, representing the time elapsed since the start of a day (00:00:00). Supports positive or negative integers. |
 
-### keywords
-    SEC_TO_TIME
+## Return Value
+- Returns a TIME value in the format `HH:MM:SS`, representing the time calculated from the start of a day (00:00:00).
+- If <seconds> is NULL, the function returns NULL.
+
+## Example
+```sql
+SELECT SEC_TO_TIME(59738);
+```
+```text
++--------------------+
+| sec_to_time(59738) |
++--------------------+
+| 16:35:38           |
++--------------------+
+```
\ No newline at end of file
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
index 8c3fa5cc0ebff..0267059455642 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_ceil",
+    "title": "SECOND_CEIL",
     "language": "en"
 }
 ---
@@ -24,39 +24,69 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_ceil
-### description
-#### Syntax
+## Description
+The function aligns the input datetime value upwards to the nearest second boundary based on the specified period and returns the aligned datetime value.
+
+## Syntax
 
 ```sql
-DATETIME SECOND_CEIL(DATETIME datetime)
-DATETIME SECOND_CEIL(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period, DATETIME origin)
+SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 ```
+## Parameters
 
-Convert the date to the nearest rounding up time of the specified time interval period.
-
-- datetime: a valid date expression.
-- period: specifies how many seconds each cycle consists of.
-- origin: starting from 0001-01-01T00:00:00.
+| Parameter           | Description                                                                                                               |
+|---------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>`        | Required. The input datetime value. Supports the DATETIME type.                                                           |
+| `<period>`          | Optional. Specifies the number of seconds in each period. Supports positive integers (INT). Defaults to 1 second.         |
+| `<origin_datetime>` | Optional. The starting point for alignment. Supports the DATETIME type. Defaults to 0001-01-01T00:00:00 if not specified. |
 
-### example
+## Return Value
+- Returns a datetime value representing the input datetime aligned upwards to the nearest specified second boundary.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
+## Example
+Only specifying `<datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56');
+```
+```text
++-----------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++-----------------------------------------------------------+
+| 2025-01-23 12:34:56                                       |
++-----------------------------------------------------------+
 ```
-mysql> select second_ceil("2023-07-13 22:28:18", 5);
+Specifying `<datetime>` and `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++---------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++---------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                     |
++---------------------------------------------------------------------------------------------------------+
+```
+Specifying `<datetime>` and `<period>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
+```
+```text
 +--------------------------------------------------------------+
-| second_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +--------------------------------------------------------------+
-| 2023-07-13 22:28:20                                          |
+| 2025-01-23 12:35:00                                          |
 +--------------------------------------------------------------+
-1 row in set (0.01 sec)
 ```
-
-### keywords
-
-    SECOND_CEIL, SECOND, CEIL
-
-### Best Practice
-
-See also [date_ceil](./date_ceil)
+Specifying `<datetime>`，`<period>` and `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++-------------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++-------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:35:00                                                                                         |
++-------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
index 4207631f393a8..5e9f420bfdd3e 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_floor",
+    "title": "SECOND_FLOOR",
     "language": "en"
 }
 ---
@@ -24,39 +24,69 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_floor
-### description
-#### Syntax
+## Description
+The function aligns the input datetime value upwards to the nearest second boundary based on the specified period and returns the aligned datetime value.
+
+## Syntax
 
 ```sql
-DATETIME SECOND_FLOOR(DATETIME datetime)
-DATETIME SECOND_FLOOR(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period, DATETIME origin)
+SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 ```
+## Parameters
 
-Convert the date to the nearest rounding down time of the specified time interval period.
-
-- datetime: a valid date expression.
-- period: specifies how many seconds each cycle consists of.
-- origin: starting from 0001-01-01T00:00:00.
+| Parameter           | Description                                                                                                               |
+|---------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>`        | Required. The input datetime value. Supports the DATETIME type.                                                           |
+| `<period>`          | Optional. Specifies the number of seconds in each period. Supports positive integers (INT). Defaults to 1 second.         |
+| `<origin_datetime>` | Optional. The starting point for alignment. Supports the DATETIME type. Defaults to 0001-01-01T00:00:00 if not specified. |
 
-### example
+## Return Value
+- Returns a datetime value representing the input datetime aligned upwards to the nearest specified second boundary.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
+## Example
+Only specifying `<datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+```
+```text
++------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++------------------------------------------------------------+
+| 2025-01-23 12:34:56                                        |
++------------------------------------------------------------+
 ```
-mysql> select second_floor("2023-07-13 22:28:18", 5);
+Specifying `<datetime>` and `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                      |
++----------------------------------------------------------------------------------------------------------+
+```
+Specifying `<datetime>` and `<period>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5)
+```
+```text
 +---------------------------------------------------------------+
-| second_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +---------------------------------------------------------------+
-| 2023-07-13 22:28:15                                           |
+| 2025-01-23 12:34:55                                           |
 +---------------------------------------------------------------+
-1 row in set (0.10 sec)
 ```
-
-### keywords
-
-    SECOND_FLOOR, SECOND, FLOOR
-
-### Best Practice
-
-See also [date_floor](./date_floor)
+Specifying `<datetime>`，`<period>` and `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++--------------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++--------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:50                                                                                          |
++--------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
index cbe73597cfed9..d788ac919357d 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
@@ -25,23 +25,32 @@ under the License.
 -->
 
 ## Description
+The function returns the second part of the specified datetime value. The range of seconds is 0 to 59.
 
-Returns second information in the time type, ranging from 0,59
+## Syntax
+
+```sql
+SECOND(<datetime>)
+```
+## Parameters
 
-The parameter is Date or Datetime or Time type
+| Parameter    | Description                                                        |
+|--------------|--------------------------------------------------------------------|
+| `<datetime>` | The input date or datetime value. Supports DATE or DATETIME types. |
 
-## Syntax
-`INT SECOND(DATETIME date)`
+## Return Value
+- Returns an integer representing the second part of the input datetime value, ranging from 0 to 59.
+- If the input is NULL, the function returns NULL.
+- If the input is an invalid date (e.g., 0000-00-00 00:00:00), the function returns NULL.
 
 ## Example
-
 ```sql
-mysql> select second('2018-12-31 23:59:59');
-+-----------------------------+
-| second('2018-12-31 23:59:59') |
-+-----------------------------+
-|                          59 |
-+-----------------------------+
+select second('2018-12-31 23:59:59');
 ```
-## Keywords
-    SECOND
+```text
++---------------------------------------------+
+| second(cast('2018-12-30' as DATETIMEV2(0))) |
++---------------------------------------------+
+|                                           0 |
++---------------------------------------------+
+```
\ No newline at end of file
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 dcf5bdfb8ef59..8786db7e48dd5 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
@@ -1,7 +1,7 @@
 ---
 {
-    "title": "SECONDS_ADD",
-    "language": "en"
+  "title": "SECONDS_ADD",
+  "language": "en"
 }
 ---
 
@@ -24,27 +24,38 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_add
-### description
-#### Syntax
+## Description
 
-`DATETIME SECONDS_ADD(DATETIME date, INT seconds)`
+The function adds or subtracts a specified number of seconds to/from a given datetime value and returns the resulting
+datetime.
 
-ADD a specified number of seconds from a datetime or date
+## Syntax
 
-The parameter date can be DATETIME or DATE, and the return type is DATETIME.
+```sql
+SECONDS_ADD(<datetime>, <seconds>)
+```
 
-### example
+## Parameters
 
-```
-mysql> select seconds_add("2020-02-02 02:02:02", 1);
-+---------------------------------------+
-| seconds_add('2020-02-02 02:02:02', 1) |
-+---------------------------------------+
-| 2020-02-02 02:02:03                   |
-+---------------------------------------+
-```
+| Parameter    | Description                                                                                                                                         |
+|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>` | Required. The input datetime value. Supports the DATETIME and DATE type.                                                                            |
+| `<seconds>`  | Required. The number of seconds to add or subtract. Supports integers (INT). Positive numbers add seconds, while negative numbers subtract seconds. |
+
+## Return Value
+- Returns a datetime value of the same type as the input <datetime>.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
-### keywords
+## Examples
 
-    SECONDS_ADD
+```
+SELECT SECONDS_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
index c8e5e5208f3f9..798bbd90293b6 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
@@ -24,25 +24,37 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_diff
-### description
-#### Syntax
+## Description
+The function calculates the time difference between two datetime values and returns the difference in seconds.
 
-`INT seconds_diff(DATETIME enddate, DATETIME startdate)`
-
-The difference between the start time and the end time is seconds
-
-### example
+## Syntax
 
+```sql
+SECONDS_DIFF(<end_datetime>, <start_datetime>)
 ```
-mysql> select seconds_diff('2020-12-25 22:00:00','2020-12-25 21:00:00');
-+------------------------------------------------------------+
-| seconds_diff('2020-12-25 22:00:00', '2020-12-25 21:00:00') |
-+------------------------------------------------------------+
-|                                                       3600 |
-+------------------------------------------------------------+
+## Parameters
+
+| Parameter          | Description                                                                 |
+|--------------------|-----------------------------------------------------------------------------|
+| `<end_datetime>`   | Required. The ending datetime value. Supports the DATETIME and DATE type.   |
+| `<start_datetime>` | Required. The starting datetime value. Supports the DATETIME and DATE type. |
+
+## Return Value
+- Returns an integer representing the difference in seconds between two datetime values:
+  - If `<end_datetime>` is later than `<start_datetime>`, returns a positive value.
+  - If `<end_datetime>` is earlier than `<start_datetime>`, returns a negative value.
+  - If `<end_datetime>` and `<start_datetime>` are equal, returns 0.
+- If either parameter is NULL, the function returns NULL.
+- If the input datetime values are invalid (e.g., 0000-00-00T00:00:00), the function returns NULL.
+
+## Example
+```sql
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+|                                                                                                       60 |
++----------------------------------------------------------------------------------------------------------+
 ```
-
-### keywords
-
-    seconds_diff
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 6708256636579..34420b7c046e2 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
@@ -24,27 +24,38 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_sub
-### description
-#### Syntax
+## Description
 
-`DATETIME SECONDS_SUB(DATETIME date, INT seconds)`
+The function subtracts or adds a specified number of seconds to/from a given datetime value and returns the resulting
+datetime.
 
-Subtracts a specified number of seconds from a datetime or date
+## Syntax
 
-The parameter date can be DATETIME or DATE, and the return type is DATETIME.
+```sql
+SECONDS_SUB(<datetime>, <seconds>)
+```
 
-### example
+## Parameters
 
-```
-mysql> select seconds_sub("2020-01-01 00:00:00", 1);
-+---------------------------------------+
-| seconds_sub('2020-01-01 00:00:00', 1) |
-+---------------------------------------+
-| 2019-12-31 23:59:59                   |
-+---------------------------------------+
-```
+| Parameter    | Description                                                                                                                                         |
+|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>` | Required. The input datetime value. Supports the DATETIME and DATE type.                                                                            |
+| `<seconds>`  | Required. The number of seconds to subtract or add. Supports integers (INT). Positive numbers add seconds, while negative numbers subtract seconds. |
+
+## Return Value
+- Returns a datetime value of the same type as the input <datetime>.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
-### keywords
+## Examples
 
-    SECONDS_SUB
+```
+SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
index f0ac58826eca8..f405043ec3e4d 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## time_to_sec
-### description
-#### Syntax
+## Description
+The function converts an input `TIME` or `DATETIME` value into the total time in seconds. If the input is of `DATETIME` type, the function automatically extracts the time part (`HH:MM:SS`).
 
-`INT time_to_sec(TIME datetime)`
 
-input parameter is the time type
-Convert the specified time value to seconds, returned result is: hours × 3600+ minutes×60 + seconds.
-
-### example
+## Syntax
 
+```sql
+TIME_TO_SEC(<time>)
 ```
-mysql >select current_time(),time_to_sec(current_time());
-+----------------+-----------------------------+
-| current_time() | time_to_sec(current_time()) |
-+----------------+-----------------------------+
-| 16:32:18       |                       59538 |
-+----------------+-----------------------------+
-1 row in set (0.01 sec)
+## Parameters
+
+| Parameter | Description                                                                                                                |
+|-----------|----------------------------------------------------------------------------------------------------------------------------|
+| `<time>`  | Required. Supports TIME or DATETIME values. If the input is DATETIME, the function extracts the time part for calculation. |
+
+## Return Value
+- Returns an integer representing the total seconds of the input time value.
+- If <time> is NULL, the function returns NULL.
+
+## Example
+
+```sql
+SELECT TIME_TO_SEC('16:32:18'),TIME_TO_SEC('2025-01-01 16:32:18');
 ```
-### keywords
-    TIME_TO_SEC
+```text
++---------------------------------------+--------------------------------------------------+
+| time_to_sec(cast('16:32:18' as TIME)) | time_to_sec(cast('2025-01-01 16:32:18' as TIME)) |
++---------------------------------------+--------------------------------------------------+
+|                                 59538 |                                            59538 |
++---------------------------------------+--------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
index 4b683e9fda1af..c99f01e12b23c 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
@@ -24,25 +24,32 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## sec_to_time
 ## 描述
+`SEC_TO_TIME` 函数将一个以秒为单位的值转换为 `TIME` 类型，返回格式为 `HH:MM:SS`。输入的秒数表示从一天的起点时间（`00:00:00`）开始计算的时间。
 ## 语法
 
-`TIME sec_to_time(INT timestamp)`
+```sql
+SEC_TO_TIME(<seconds>)
+```
 
-参数为INT类型时间戳，函数返回TIME类型时间。
+## 参数
 
-## 举例
+| 参数            | 说明                                                |
+|---------------|---------------------------------------------------|
+| `<seconds>` | 必填，输入的秒数，表示从一天起点时间（00:00:00）开始计算的秒数，支持正整数或负整数类型。 |
 
-```
-mysql >select sec_to_time(time_to_sec(cast('16:32:18' as time)));
-+----------------------------------------------------+
-| sec_to_time(time_to_sec(CAST('16:32:18' AS TIME))) |
-+----------------------------------------------------+
-| 16:32:18                                           |
-+----------------------------------------------------+
-1 row in set (0.53 sec)
-```
+## 返回值
+- 返回一个 TIME 类型值，格式为 `HH:MM:SS`，表示从起点时间（00:00:00）开始计算的时间。
+- 如果输入的 `<seconds>` 为 NULL，函数返回 NULL。
 
-### keywords
-    SEC_TO_TIME
+## 举例
+```sql
+SELECT SEC_TO_TIME(59738);
+```
+```text
++--------------------+
+| sec_to_time(59738) |
++--------------------+
+| 16:35:38           |
++--------------------+
+```
\ No newline at end of file
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 4d18264621096..511ed44d68685 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
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_ceil",
+    "title": "SECOND_CEIL",
     "language": "zh-CN"
 }
 ---
@@ -24,39 +24,70 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_ceil
 ## 描述
+函数用于将输入的日期时间值向上对齐到指定的秒周期边界，并返回对齐后的日期时间值。
+
 ## 语法
 
 ```sql
-DATETIME SECOND_CEIL(DATETIME datetime)
-DATETIME SECOND_CEIL(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period, DATETIME origin)
+SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 ```
 
-将日期转化为指定的时间间隔周期的最近上取整时刻。
+## 参数
 
-- datetime：参数是合法的日期表达式。
-- period：参数是指定每个周期有多少秒组成。
-- origin：开始的时间起点，如果不填，默认是 0001-01-01T00:00:00。
+| 参数                  | 说明                                                       |
+|---------------------|----------------------------------------------------------|
+| `<datetime>`        | 必填，输入的日期时间值，支持 DATETIME 类型。                              |
+| `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
+| `<origin_datetime>` | 可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
-## 举例
+## 返回值
+- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
+- 如果输入的 `<datetime>` 为 NULL，返回 NULL。
+- 如果输入的 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），返回 NULL。
 
+## 举例
+只指定参数`<datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56');
+```
+```text
++-----------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++-----------------------------------------------------------+
+| 2025-01-23 12:34:56                                       |
++-----------------------------------------------------------+
+```
+指定参数 `<datetime>`， `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++---------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++---------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                     |
++---------------------------------------------------------------------------------------------------------+
 ```
-mysql> select second_ceil("2023-07-13 22:28:18", 5);
+指定参数 `<datetime>`，`<period>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
+```
+```text
 +--------------------------------------------------------------+
-| second_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +--------------------------------------------------------------+
-| 2023-07-13 22:28:20                                          |
+| 2025-01-23 12:35:00                                          |
 +--------------------------------------------------------------+
-1 row in set (0.01 sec)
 ```
-
-### keywords
-
-    SECOND_CEIL, SECOND, CEIL
-
-### Best Practice
-
-还可参阅 [date_ceil](./date_ceil)
+同时指定   `<datetime>`，`<period>`，`<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++-------------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++-------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:35:00                                                                                         |
++-------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
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 bc2abd1465c02..59cfa0d58f67b 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
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_floor",
+    "title": "SECOND_FLOOR",
     "language": "zh-CN"
 }
 ---
@@ -24,39 +24,70 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_floor
 ## 描述
+函数用于将输入的日期时间值向下对齐到指定的秒周期边界，并返回对齐后的日期时间值。
+
 ## 语法
 
 ```sql
-DATETIME SECOND_FLOOR(DATETIME datetime)
-DATETIME SECOND_FLOOR(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period, DATETIME origin)
+SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 ```
 
-将日期转化为指定的时间间隔周期的最近下取整时刻。
+## 参数
 
-- datetime：参数是合法的日期表达式。
-- period：参数是指定每个周期有多少天组成。
-- origin：开始的时间起点，如果不填，默认是 0001-01-01T00:00:00。
+| 参数                  | 说明                                                       |
+|---------------------|----------------------------------------------------------|
+| `<datetime>`        | 必填，输入的日期时间值，支持 DATETIME 类型。                              |
+| `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
+| `<origin_datetime>` | 可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
-## 举例
+## 返回值
+- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
+- 如果输入的 `<datetime>` 为 NULL，返回 NULL。
+- 如果输入的 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），返回 NULL。
 
+## 举例
+只指定参数`<datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+```
+```text
++------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++------------------------------------------------------------+
+| 2025-01-23 12:34:56                                        |
++------------------------------------------------------------+
+```
+指定参数 `<datetime>`， `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                      |
++----------------------------------------------------------------------------------------------------------+
 ```
-mysql> select second_floor("2023-07-13 22:28:18", 5);
+指定参数 `<datetime>`，`<period>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5);
+```
+```text
 +---------------------------------------------------------------+
-| second_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +---------------------------------------------------------------+
-| 2023-07-13 22:28:15                                           |
+| 2025-01-23 12:34:55                                           |
 +---------------------------------------------------------------+
-1 row in set (0.10 sec)
 ```
-
-### keywords
-
-    SECOND_FLOOR, SECOND, FLOOR
-
-### Best Practice
-
-还可参阅 [date_floor](./date_floor)
+同时指定   `<datetime>`，`<period>`，`<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++--------------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++--------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:50                                                                                          |
++--------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
index 530fa4d66946e..90554d87938ba 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
@@ -24,27 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## Description
+## 描述
+函数用于返回指定日期时间值中的秒数部分。秒数的范围是 0 到 59。
 
+## 语法
 
+```sql
+SECOND(<datetime>)
+```
 
-获得日期中的秒的信息，返回值范围从 0-59。
-
-参数为 Date 或者 Datetime，Time 类型
-
-## Syntax
+## 参数
 
-`INT SECOND(DATETIME date)`
+| 参数           | 说明                                 |
+|--------------|------------------------------------|
+| `<datetime>` | 输入的日期或日期时间值，支持 DATE 或 DATETIME 类型。 |
 
-## Example
+## 返回值
+- 返回一个整数，表示输入日期时间值中的秒数部分，范围为 0 到 59。
+- 如果输入值为 NULL，函数返回 NULL。
+- 如果输入值为非法日期（如 0000-00-00 00:00:00），函数返回 NULL。
 
+## 举例
 ```sql
-mysql> select second('2018-12-31 23:59:59');
-+-----------------------------+
-| second('2018-12-31 23:59:59') |
-+-----------------------------+
-|                          59 |
-+-----------------------------+
+select second('2018-12-31 23:59:59');
 ```
-## Keywords
-    SECOND
+```text
++------------------------------------------------------+
+| second(cast('2018-12-31 23:59:59' as DATETIMEV2(0))) |
++------------------------------------------------------+
+|                                                   59 |
++------------------------------------------------------+
+```
\ No newline at end of file
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 bf3ab97f2e741..de68bce3ce0f5 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
@@ -24,27 +24,35 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_add
 ## 描述
+函数用于在指定的日期时间值上增加或减少指定的秒数，并返回计算后的日期时间值
+
 ## 语法
 
-`DATETIME SECONDS_ADD(DATETIME date, INT seconds)`
+```sql
+SECONDS_ADD(<datetime>, <seconds>)
+```
+## 参数
 
-从日期时间或日期加上指定秒数
+| 参数           | 说明                                          |
+|--------------|---------------------------------------------|
+| `<datetime>` | 必填，输入的日期时间值，支持 DATETIME 或 DATE 类型           |
+| `<seconds>`  | 必填，要增加或减少的秒数，支持整数类型（INT）。正数表示增加秒数，负数表示减少秒数。 |
 
-参数 date 可以是 DATETIME 或者 DATE 类型，返回类型为 DATETIME。
+## 返回值
+- 返回一个日期时间值，类型与输入的 `<datetime>` 类型一致。
+- 如果 `<datetime>` 为 NULL，函数返回 NULL。
+- 如果 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
 
-## 举例
 
+## 举例
 ```
-mysql> select seconds_add("2020-02-02 02:02:02", 1);
-+---------------------------------------+
-| seconds_add('2020-02-02 02:02:02', 1) |
-+---------------------------------------+
-| 2020-02-02 02:02:03                   |
-+---------------------------------------+
+SELECT SECONDS_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
 ```
-
-### keywords
-
-    SECONDS_ADD
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
index 4d45fa7047921..0bffe6a394654 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
@@ -24,25 +24,39 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_diff
 ## 描述
-## 语法
-
-`INT seconds_diff(DATETIME enddate, DATETIME startdate)`
+函数用于计算两个日期时间值之间的时间差，以秒为单位返回差值。
 
-开始时间到结束时间相差几秒
 
-## 举例
+## 语法
 
-```
-mysql> select seconds_diff('2020-12-25 22:00:00','2020-12-25 21:00:00');
-+------------------------------------------------------------+
-| seconds_diff('2020-12-25 22:00:00', '2020-12-25 21:00:00') |
-+------------------------------------------------------------+
-|                                                       3600 |
-+------------------------------------------------------------+
+```sql
+SECONDS_DIFF(<end_datetime>, <start_datetime>)
 ```
 
-### keywords
+## 参数
 
-    seconds_diff
+| 参数                 | 说明                                 |
+|--------------------|------------------------------------|
+| `<end_datetime>`   | 必填，结束的日期时间值，支持 DATETIME 或 DATE 类型。 |
+| `<start_datetime>` | 必填，起始的日期时间值，支持 DATETIME 或 DATE 类型。 |
+
+## 返回值
+- 返回一个整数，表示两个日期时间值之间的秒差：
+  - 如果 `<end_datetime>` 晚于 `<start_datetime>`，返回正数。
+  - 如果 `<end_datetime>` 早于 `<start_datetime>`，返回负数。
+  - 如果 `<end_datetime>` 和 `<start_datetime>` 相等，返回 0。
+- 如果任一参数为 NULL，函数返回 NULL。
+- 如果输入的日期时间值为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
+
+## 举例
+```sql
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+|                                                                                                       60 |
++----------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
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 e678250f1333b..91af2923f362b 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
@@ -24,27 +24,35 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_sub
 ## 描述
+函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值
+
 ## 语法
 
-`DATETIME SECONDS_SUB(DATETIME date, INT seconds)`
+```sql
+SECONDS_SUB(<datetime>, <seconds>)
+```
+## 参数
+
+| 参数           | 说明                                          |
+|--------------|---------------------------------------------|
+| `<datetime>` | 必填，输入的日期时间值，支持 DATETIME 或 DATE 类型           |
+| `<seconds>`  | 必填，要减少或增加的秒数，支持整数类型（INT）。正数表示增加秒数，负数表示减少秒数。 |
 
-从日期时间或日期减去指定秒数
+## 返回值
+- 返回一个日期时间值，类型与输入的 `<datetime>` 类型一致。
+- 如果 `<datetime>` 为 NULL，函数返回 NULL。
+- 如果 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
 
-参数 date 可以是 DATETIME 或者 DATE 类型，返回类型为 DATETIME。
 
 ## 举例
-
 ```
-mysql> select seconds_sub("2020-01-01 00:00:00", 1);
-+---------------------------------------+
-| seconds_sub('2020-01-01 00:00:00', 1) |
-+---------------------------------------+
-| 2019-12-31 23:59:59                   |
-+---------------------------------------+
+SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
 ```
-
-### keywords
-
-    SECONDS_SUB
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
index ffff53ec059da..68af9a99df6f4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## time_to_sec
 ## 描述
+函数将输入的 `TIME` 或 `DATETIME` 类型的值转换为以秒为单位的总时间。如果输入为 `DATETIME` 类型，函数会自动提取时间部分（`HH:MM:SS`）。
+
 ## 语法
 
-`INT time_to_sec(TIME datetime)`
+```sql
+TIME_TO_SEC(<time>)
+```
+
+## 参数
 
-参数为Datetime类型
-将指定的时间值转为秒数，即返回结果为：小时×3600 + 分钟×60 + 秒。
+| 参数       | 说明                                                          |
+|----------|-------------------------------------------------------------|
+| `<time>` | 必填，支持 TIME 或 DATETIME 类型的值。如果输入为 DATETIME 类型，函数会提取时间部分进行计算。 |
+
+## 返回值
+- 返回一个整数，表示输入时间值转换为总秒数的结果。
+- 如果输入的 `<time>` 为 NULL，函数返回 NULL。
 
 ## 举例
 
+```sql
+SELECT TIME_TO_SEC('16:32:18'),TIME_TO_SEC('2025-01-01 16:32:18');
 ```
-mysql >select current_time(),time_to_sec(current_time());
-+----------------+-----------------------------+
-| current_time() | time_to_sec(current_time()) |
-+----------------+-----------------------------+
-| 16:32:18       |                       59538 |
-+----------------+-----------------------------+
-1 row in set (0.01 sec)
-```
-### keywords
-    TIME_TO_SEC
+```text
++---------------------------------------+--------------------------------------------------+
+| time_to_sec(cast('16:32:18' as TIME)) | time_to_sec(cast('2025-01-01 16:32:18' as TIME)) |
++---------------------------------------+--------------------------------------------------+
+|                                 59538 |                                            59538 |
++---------------------------------------+--------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/sec-to-time.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/sec-to-time.md
index 4b683e9fda1af..c99f01e12b23c 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/sec-to-time.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/sec-to-time.md
@@ -24,25 +24,32 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## sec_to_time
 ## 描述
+`SEC_TO_TIME` 函数将一个以秒为单位的值转换为 `TIME` 类型，返回格式为 `HH:MM:SS`。输入的秒数表示从一天的起点时间（`00:00:00`）开始计算的时间。
 ## 语法
 
-`TIME sec_to_time(INT timestamp)`
+```sql
+SEC_TO_TIME(<seconds>)
+```
 
-参数为INT类型时间戳，函数返回TIME类型时间。
+## 参数
 
-## 举例
+| 参数            | 说明                                                |
+|---------------|---------------------------------------------------|
+| `<seconds>` | 必填，输入的秒数，表示从一天起点时间（00:00:00）开始计算的秒数，支持正整数或负整数类型。 |
 
-```
-mysql >select sec_to_time(time_to_sec(cast('16:32:18' as time)));
-+----------------------------------------------------+
-| sec_to_time(time_to_sec(CAST('16:32:18' AS TIME))) |
-+----------------------------------------------------+
-| 16:32:18                                           |
-+----------------------------------------------------+
-1 row in set (0.53 sec)
-```
+## 返回值
+- 返回一个 TIME 类型值，格式为 `HH:MM:SS`，表示从起点时间（00:00:00）开始计算的时间。
+- 如果输入的 `<seconds>` 为 NULL，函数返回 NULL。
 
-### keywords
-    SEC_TO_TIME
+## 举例
+```sql
+SELECT SEC_TO_TIME(59738);
+```
+```text
++--------------------+
+| sec_to_time(59738) |
++--------------------+
+| 16:35:38           |
++--------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-ceil.md
index 4d18264621096..511ed44d68685 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-ceil.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_ceil",
+    "title": "SECOND_CEIL",
     "language": "zh-CN"
 }
 ---
@@ -24,39 +24,70 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_ceil
 ## 描述
+函数用于将输入的日期时间值向上对齐到指定的秒周期边界，并返回对齐后的日期时间值。
+
 ## 语法
 
 ```sql
-DATETIME SECOND_CEIL(DATETIME datetime)
-DATETIME SECOND_CEIL(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period, DATETIME origin)
+SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 ```
 
-将日期转化为指定的时间间隔周期的最近上取整时刻。
+## 参数
 
-- datetime：参数是合法的日期表达式。
-- period：参数是指定每个周期有多少秒组成。
-- origin：开始的时间起点，如果不填，默认是 0001-01-01T00:00:00。
+| 参数                  | 说明                                                       |
+|---------------------|----------------------------------------------------------|
+| `<datetime>`        | 必填，输入的日期时间值，支持 DATETIME 类型。                              |
+| `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
+| `<origin_datetime>` | 可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
-## 举例
+## 返回值
+- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
+- 如果输入的 `<datetime>` 为 NULL，返回 NULL。
+- 如果输入的 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），返回 NULL。
 
+## 举例
+只指定参数`<datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56');
+```
+```text
++-----------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++-----------------------------------------------------------+
+| 2025-01-23 12:34:56                                       |
++-----------------------------------------------------------+
+```
+指定参数 `<datetime>`， `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++---------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++---------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                     |
++---------------------------------------------------------------------------------------------------------+
 ```
-mysql> select second_ceil("2023-07-13 22:28:18", 5);
+指定参数 `<datetime>`，`<period>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
+```
+```text
 +--------------------------------------------------------------+
-| second_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +--------------------------------------------------------------+
-| 2023-07-13 22:28:20                                          |
+| 2025-01-23 12:35:00                                          |
 +--------------------------------------------------------------+
-1 row in set (0.01 sec)
 ```
-
-### keywords
-
-    SECOND_CEIL, SECOND, CEIL
-
-### Best Practice
-
-还可参阅 [date_ceil](./date_ceil)
+同时指定   `<datetime>`，`<period>`，`<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++-------------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++-------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:35:00                                                                                         |
++-------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-floor.md
index bc2abd1465c02..59cfa0d58f67b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-floor.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_floor",
+    "title": "SECOND_FLOOR",
     "language": "zh-CN"
 }
 ---
@@ -24,39 +24,70 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_floor
 ## 描述
+函数用于将输入的日期时间值向下对齐到指定的秒周期边界，并返回对齐后的日期时间值。
+
 ## 语法
 
 ```sql
-DATETIME SECOND_FLOOR(DATETIME datetime)
-DATETIME SECOND_FLOOR(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period, DATETIME origin)
+SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 ```
 
-将日期转化为指定的时间间隔周期的最近下取整时刻。
+## 参数
 
-- datetime：参数是合法的日期表达式。
-- period：参数是指定每个周期有多少天组成。
-- origin：开始的时间起点，如果不填，默认是 0001-01-01T00:00:00。
+| 参数                  | 说明                                                       |
+|---------------------|----------------------------------------------------------|
+| `<datetime>`        | 必填，输入的日期时间值，支持 DATETIME 类型。                              |
+| `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
+| `<origin_datetime>` | 可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
-## 举例
+## 返回值
+- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
+- 如果输入的 `<datetime>` 为 NULL，返回 NULL。
+- 如果输入的 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），返回 NULL。
 
+## 举例
+只指定参数`<datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+```
+```text
++------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++------------------------------------------------------------+
+| 2025-01-23 12:34:56                                        |
++------------------------------------------------------------+
+```
+指定参数 `<datetime>`， `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                      |
++----------------------------------------------------------------------------------------------------------+
 ```
-mysql> select second_floor("2023-07-13 22:28:18", 5);
+指定参数 `<datetime>`，`<period>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5);
+```
+```text
 +---------------------------------------------------------------+
-| second_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +---------------------------------------------------------------+
-| 2023-07-13 22:28:15                                           |
+| 2025-01-23 12:34:55                                           |
 +---------------------------------------------------------------+
-1 row in set (0.10 sec)
 ```
-
-### keywords
-
-    SECOND_FLOOR, SECOND, FLOOR
-
-### Best Practice
-
-还可参阅 [date_floor](./date_floor)
+同时指定   `<datetime>`，`<period>`，`<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++--------------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++--------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:50                                                                                          |
++--------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second.md
index a9dc14badb53d..90554d87938ba 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/second.md
@@ -24,26 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second
 ## 描述
+函数用于返回指定日期时间值中的秒数部分。秒数的范围是 0 到 59。
+
 ## 语法
 
-`INT SECOND(DATETIME date)`
+```sql
+SECOND(<datetime>)
+```
 
+## 参数
 
-获得日期中的秒的信息，返回值范围从0-59。
+| 参数           | 说明                                 |
+|--------------|------------------------------------|
+| `<datetime>` | 输入的日期或日期时间值，支持 DATE 或 DATETIME 类型。 |
 
-参数为Date或者Datetime类型
+## 返回值
+- 返回一个整数，表示输入日期时间值中的秒数部分，范围为 0 到 59。
+- 如果输入值为 NULL，函数返回 NULL。
+- 如果输入值为非法日期（如 0000-00-00 00:00:00），函数返回 NULL。
 
 ## 举例
-
-```
-mysql> select second('2018-12-31 23:59:59');
-+-----------------------------+
-| second('2018-12-31 23:59:59') |
-+-----------------------------+
-|                          59 |
-+-----------------------------+
+```sql
+select second('2018-12-31 23:59:59');
 ```
-### keywords
-    SECOND
+```text
++------------------------------------------------------+
+| second(cast('2018-12-31 23:59:59' as DATETIMEV2(0))) |
++------------------------------------------------------+
+|                                                   59 |
++------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-add.md
index bf3ab97f2e741..de68bce3ce0f5 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-add.md
@@ -24,27 +24,35 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_add
 ## 描述
+函数用于在指定的日期时间值上增加或减少指定的秒数，并返回计算后的日期时间值
+
 ## 语法
 
-`DATETIME SECONDS_ADD(DATETIME date, INT seconds)`
+```sql
+SECONDS_ADD(<datetime>, <seconds>)
+```
+## 参数
 
-从日期时间或日期加上指定秒数
+| 参数           | 说明                                          |
+|--------------|---------------------------------------------|
+| `<datetime>` | 必填，输入的日期时间值，支持 DATETIME 或 DATE 类型           |
+| `<seconds>`  | 必填，要增加或减少的秒数，支持整数类型（INT）。正数表示增加秒数，负数表示减少秒数。 |
 
-参数 date 可以是 DATETIME 或者 DATE 类型，返回类型为 DATETIME。
+## 返回值
+- 返回一个日期时间值，类型与输入的 `<datetime>` 类型一致。
+- 如果 `<datetime>` 为 NULL，函数返回 NULL。
+- 如果 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
 
-## 举例
 
+## 举例
 ```
-mysql> select seconds_add("2020-02-02 02:02:02", 1);
-+---------------------------------------+
-| seconds_add('2020-02-02 02:02:02', 1) |
-+---------------------------------------+
-| 2020-02-02 02:02:03                   |
-+---------------------------------------+
+SELECT SECONDS_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
 ```
-
-### keywords
-
-    SECONDS_ADD
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-diff.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-diff.md
index 4d45fa7047921..0bffe6a394654 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-diff.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-diff.md
@@ -24,25 +24,39 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_diff
 ## 描述
-## 语法
-
-`INT seconds_diff(DATETIME enddate, DATETIME startdate)`
+函数用于计算两个日期时间值之间的时间差，以秒为单位返回差值。
 
-开始时间到结束时间相差几秒
 
-## 举例
+## 语法
 
-```
-mysql> select seconds_diff('2020-12-25 22:00:00','2020-12-25 21:00:00');
-+------------------------------------------------------------+
-| seconds_diff('2020-12-25 22:00:00', '2020-12-25 21:00:00') |
-+------------------------------------------------------------+
-|                                                       3600 |
-+------------------------------------------------------------+
+```sql
+SECONDS_DIFF(<end_datetime>, <start_datetime>)
 ```
 
-### keywords
+## 参数
 
-    seconds_diff
+| 参数                 | 说明                                 |
+|--------------------|------------------------------------|
+| `<end_datetime>`   | 必填，结束的日期时间值，支持 DATETIME 或 DATE 类型。 |
+| `<start_datetime>` | 必填，起始的日期时间值，支持 DATETIME 或 DATE 类型。 |
+
+## 返回值
+- 返回一个整数，表示两个日期时间值之间的秒差：
+  - 如果 `<end_datetime>` 晚于 `<start_datetime>`，返回正数。
+  - 如果 `<end_datetime>` 早于 `<start_datetime>`，返回负数。
+  - 如果 `<end_datetime>` 和 `<start_datetime>` 相等，返回 0。
+- 如果任一参数为 NULL，函数返回 NULL。
+- 如果输入的日期时间值为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
+
+## 举例
+```sql
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+|                                                                                                       60 |
++----------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-sub.md
index e678250f1333b..91af2923f362b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-sub.md
@@ -24,27 +24,35 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_sub
 ## 描述
+函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值
+
 ## 语法
 
-`DATETIME SECONDS_SUB(DATETIME date, INT seconds)`
+```sql
+SECONDS_SUB(<datetime>, <seconds>)
+```
+## 参数
+
+| 参数           | 说明                                          |
+|--------------|---------------------------------------------|
+| `<datetime>` | 必填，输入的日期时间值，支持 DATETIME 或 DATE 类型           |
+| `<seconds>`  | 必填，要减少或增加的秒数，支持整数类型（INT）。正数表示增加秒数，负数表示减少秒数。 |
 
-从日期时间或日期减去指定秒数
+## 返回值
+- 返回一个日期时间值，类型与输入的 `<datetime>` 类型一致。
+- 如果 `<datetime>` 为 NULL，函数返回 NULL。
+- 如果 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
 
-参数 date 可以是 DATETIME 或者 DATE 类型，返回类型为 DATETIME。
 
 ## 举例
-
 ```
-mysql> select seconds_sub("2020-01-01 00:00:00", 1);
-+---------------------------------------+
-| seconds_sub('2020-01-01 00:00:00', 1) |
-+---------------------------------------+
-| 2019-12-31 23:59:59                   |
-+---------------------------------------+
+SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
 ```
-
-### keywords
-
-    SECONDS_SUB
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/time-to-sec.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/time-to-sec.md
index ffff53ec059da..68af9a99df6f4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/time-to-sec.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.0/sql-manual/sql-functions/date-time-functions/time-to-sec.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## time_to_sec
 ## 描述
+函数将输入的 `TIME` 或 `DATETIME` 类型的值转换为以秒为单位的总时间。如果输入为 `DATETIME` 类型，函数会自动提取时间部分（`HH:MM:SS`）。
+
 ## 语法
 
-`INT time_to_sec(TIME datetime)`
+```sql
+TIME_TO_SEC(<time>)
+```
+
+## 参数
 
-参数为Datetime类型
-将指定的时间值转为秒数，即返回结果为：小时×3600 + 分钟×60 + 秒。
+| 参数       | 说明                                                          |
+|----------|-------------------------------------------------------------|
+| `<time>` | 必填，支持 TIME 或 DATETIME 类型的值。如果输入为 DATETIME 类型，函数会提取时间部分进行计算。 |
+
+## 返回值
+- 返回一个整数，表示输入时间值转换为总秒数的结果。
+- 如果输入的 `<time>` 为 NULL，函数返回 NULL。
 
 ## 举例
 
+```sql
+SELECT TIME_TO_SEC('16:32:18'),TIME_TO_SEC('2025-01-01 16:32:18');
 ```
-mysql >select current_time(),time_to_sec(current_time());
-+----------------+-----------------------------+
-| current_time() | time_to_sec(current_time()) |
-+----------------+-----------------------------+
-| 16:32:18       |                       59538 |
-+----------------+-----------------------------+
-1 row in set (0.01 sec)
-```
-### keywords
-    TIME_TO_SEC
+```text
++---------------------------------------+--------------------------------------------------+
+| time_to_sec(cast('16:32:18' as TIME)) | time_to_sec(cast('2025-01-01 16:32:18' as TIME)) |
++---------------------------------------+--------------------------------------------------+
+|                                 59538 |                                            59538 |
++---------------------------------------+--------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
index 4b683e9fda1af..c99f01e12b23c 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
@@ -24,25 +24,32 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## sec_to_time
 ## 描述
+`SEC_TO_TIME` 函数将一个以秒为单位的值转换为 `TIME` 类型，返回格式为 `HH:MM:SS`。输入的秒数表示从一天的起点时间（`00:00:00`）开始计算的时间。
 ## 语法
 
-`TIME sec_to_time(INT timestamp)`
+```sql
+SEC_TO_TIME(<seconds>)
+```
 
-参数为INT类型时间戳，函数返回TIME类型时间。
+## 参数
 
-## 举例
+| 参数            | 说明                                                |
+|---------------|---------------------------------------------------|
+| `<seconds>` | 必填，输入的秒数，表示从一天起点时间（00:00:00）开始计算的秒数，支持正整数或负整数类型。 |
 
-```
-mysql >select sec_to_time(time_to_sec(cast('16:32:18' as time)));
-+----------------------------------------------------+
-| sec_to_time(time_to_sec(CAST('16:32:18' AS TIME))) |
-+----------------------------------------------------+
-| 16:32:18                                           |
-+----------------------------------------------------+
-1 row in set (0.53 sec)
-```
+## 返回值
+- 返回一个 TIME 类型值，格式为 `HH:MM:SS`，表示从起点时间（00:00:00）开始计算的时间。
+- 如果输入的 `<seconds>` 为 NULL，函数返回 NULL。
 
-### keywords
-    SEC_TO_TIME
+## 举例
+```sql
+SELECT SEC_TO_TIME(59738);
+```
+```text
++--------------------+
+| sec_to_time(59738) |
++--------------------+
+| 16:35:38           |
++--------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
index 4d18264621096..511ed44d68685 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_ceil",
+    "title": "SECOND_CEIL",
     "language": "zh-CN"
 }
 ---
@@ -24,39 +24,70 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_ceil
 ## 描述
+函数用于将输入的日期时间值向上对齐到指定的秒周期边界，并返回对齐后的日期时间值。
+
 ## 语法
 
 ```sql
-DATETIME SECOND_CEIL(DATETIME datetime)
-DATETIME SECOND_CEIL(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period, DATETIME origin)
+SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 ```
 
-将日期转化为指定的时间间隔周期的最近上取整时刻。
+## 参数
 
-- datetime：参数是合法的日期表达式。
-- period：参数是指定每个周期有多少秒组成。
-- origin：开始的时间起点，如果不填，默认是 0001-01-01T00:00:00。
+| 参数                  | 说明                                                       |
+|---------------------|----------------------------------------------------------|
+| `<datetime>`        | 必填，输入的日期时间值，支持 DATETIME 类型。                              |
+| `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
+| `<origin_datetime>` | 可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
-## 举例
+## 返回值
+- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
+- 如果输入的 `<datetime>` 为 NULL，返回 NULL。
+- 如果输入的 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），返回 NULL。
 
+## 举例
+只指定参数`<datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56');
+```
+```text
++-----------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++-----------------------------------------------------------+
+| 2025-01-23 12:34:56                                       |
++-----------------------------------------------------------+
+```
+指定参数 `<datetime>`， `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++---------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++---------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                     |
++---------------------------------------------------------------------------------------------------------+
 ```
-mysql> select second_ceil("2023-07-13 22:28:18", 5);
+指定参数 `<datetime>`，`<period>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
+```
+```text
 +--------------------------------------------------------------+
-| second_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +--------------------------------------------------------------+
-| 2023-07-13 22:28:20                                          |
+| 2025-01-23 12:35:00                                          |
 +--------------------------------------------------------------+
-1 row in set (0.01 sec)
 ```
-
-### keywords
-
-    SECOND_CEIL, SECOND, CEIL
-
-### Best Practice
-
-还可参阅 [date_ceil](./date_ceil)
+同时指定   `<datetime>`，`<period>`，`<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++-------------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++-------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:35:00                                                                                         |
++-------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
index bc2abd1465c02..59cfa0d58f67b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_floor",
+    "title": "SECOND_FLOOR",
     "language": "zh-CN"
 }
 ---
@@ -24,39 +24,70 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_floor
 ## 描述
+函数用于将输入的日期时间值向下对齐到指定的秒周期边界，并返回对齐后的日期时间值。
+
 ## 语法
 
 ```sql
-DATETIME SECOND_FLOOR(DATETIME datetime)
-DATETIME SECOND_FLOOR(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period, DATETIME origin)
+SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 ```
 
-将日期转化为指定的时间间隔周期的最近下取整时刻。
+## 参数
 
-- datetime：参数是合法的日期表达式。
-- period：参数是指定每个周期有多少天组成。
-- origin：开始的时间起点，如果不填，默认是 0001-01-01T00:00:00。
+| 参数                  | 说明                                                       |
+|---------------------|----------------------------------------------------------|
+| `<datetime>`        | 必填，输入的日期时间值，支持 DATETIME 类型。                              |
+| `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
+| `<origin_datetime>` | 可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
-## 举例
+## 返回值
+- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
+- 如果输入的 `<datetime>` 为 NULL，返回 NULL。
+- 如果输入的 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），返回 NULL。
 
+## 举例
+只指定参数`<datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+```
+```text
++------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++------------------------------------------------------------+
+| 2025-01-23 12:34:56                                        |
++------------------------------------------------------------+
+```
+指定参数 `<datetime>`， `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                      |
++----------------------------------------------------------------------------------------------------------+
 ```
-mysql> select second_floor("2023-07-13 22:28:18", 5);
+指定参数 `<datetime>`，`<period>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5);
+```
+```text
 +---------------------------------------------------------------+
-| second_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +---------------------------------------------------------------+
-| 2023-07-13 22:28:15                                           |
+| 2025-01-23 12:34:55                                           |
 +---------------------------------------------------------------+
-1 row in set (0.10 sec)
 ```
-
-### keywords
-
-    SECOND_FLOOR, SECOND, FLOOR
-
-### Best Practice
-
-还可参阅 [date_floor](./date_floor)
+同时指定   `<datetime>`，`<period>`，`<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++--------------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++--------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:50                                                                                          |
++--------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
index 530fa4d66946e..90554d87938ba 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
@@ -24,27 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## Description
+## 描述
+函数用于返回指定日期时间值中的秒数部分。秒数的范围是 0 到 59。
 
+## 语法
 
+```sql
+SECOND(<datetime>)
+```
 
-获得日期中的秒的信息，返回值范围从 0-59。
-
-参数为 Date 或者 Datetime，Time 类型
-
-## Syntax
+## 参数
 
-`INT SECOND(DATETIME date)`
+| 参数           | 说明                                 |
+|--------------|------------------------------------|
+| `<datetime>` | 输入的日期或日期时间值，支持 DATE 或 DATETIME 类型。 |
 
-## Example
+## 返回值
+- 返回一个整数，表示输入日期时间值中的秒数部分，范围为 0 到 59。
+- 如果输入值为 NULL，函数返回 NULL。
+- 如果输入值为非法日期（如 0000-00-00 00:00:00），函数返回 NULL。
 
+## 举例
 ```sql
-mysql> select second('2018-12-31 23:59:59');
-+-----------------------------+
-| second('2018-12-31 23:59:59') |
-+-----------------------------+
-|                          59 |
-+-----------------------------+
+select second('2018-12-31 23:59:59');
 ```
-## Keywords
-    SECOND
+```text
++------------------------------------------------------+
+| second(cast('2018-12-31 23:59:59' as DATETIMEV2(0))) |
++------------------------------------------------------+
+|                                                   59 |
++------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
index bf3ab97f2e741..de68bce3ce0f5 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
@@ -24,27 +24,35 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_add
 ## 描述
+函数用于在指定的日期时间值上增加或减少指定的秒数，并返回计算后的日期时间值
+
 ## 语法
 
-`DATETIME SECONDS_ADD(DATETIME date, INT seconds)`
+```sql
+SECONDS_ADD(<datetime>, <seconds>)
+```
+## 参数
 
-从日期时间或日期加上指定秒数
+| 参数           | 说明                                          |
+|--------------|---------------------------------------------|
+| `<datetime>` | 必填，输入的日期时间值，支持 DATETIME 或 DATE 类型           |
+| `<seconds>`  | 必填，要增加或减少的秒数，支持整数类型（INT）。正数表示增加秒数，负数表示减少秒数。 |
 
-参数 date 可以是 DATETIME 或者 DATE 类型，返回类型为 DATETIME。
+## 返回值
+- 返回一个日期时间值，类型与输入的 `<datetime>` 类型一致。
+- 如果 `<datetime>` 为 NULL，函数返回 NULL。
+- 如果 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
 
-## 举例
 
+## 举例
 ```
-mysql> select seconds_add("2020-02-02 02:02:02", 1);
-+---------------------------------------+
-| seconds_add('2020-02-02 02:02:02', 1) |
-+---------------------------------------+
-| 2020-02-02 02:02:03                   |
-+---------------------------------------+
+SELECT SECONDS_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
 ```
-
-### keywords
-
-    SECONDS_ADD
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
index 4d45fa7047921..0bffe6a394654 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
@@ -24,25 +24,39 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_diff
 ## 描述
-## 语法
-
-`INT seconds_diff(DATETIME enddate, DATETIME startdate)`
+函数用于计算两个日期时间值之间的时间差，以秒为单位返回差值。
 
-开始时间到结束时间相差几秒
 
-## 举例
+## 语法
 
-```
-mysql> select seconds_diff('2020-12-25 22:00:00','2020-12-25 21:00:00');
-+------------------------------------------------------------+
-| seconds_diff('2020-12-25 22:00:00', '2020-12-25 21:00:00') |
-+------------------------------------------------------------+
-|                                                       3600 |
-+------------------------------------------------------------+
+```sql
+SECONDS_DIFF(<end_datetime>, <start_datetime>)
 ```
 
-### keywords
+## 参数
 
-    seconds_diff
+| 参数                 | 说明                                 |
+|--------------------|------------------------------------|
+| `<end_datetime>`   | 必填，结束的日期时间值，支持 DATETIME 或 DATE 类型。 |
+| `<start_datetime>` | 必填，起始的日期时间值，支持 DATETIME 或 DATE 类型。 |
+
+## 返回值
+- 返回一个整数，表示两个日期时间值之间的秒差：
+  - 如果 `<end_datetime>` 晚于 `<start_datetime>`，返回正数。
+  - 如果 `<end_datetime>` 早于 `<start_datetime>`，返回负数。
+  - 如果 `<end_datetime>` 和 `<start_datetime>` 相等，返回 0。
+- 如果任一参数为 NULL，函数返回 NULL。
+- 如果输入的日期时间值为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
+
+## 举例
+```sql
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+|                                                                                                       60 |
++----------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
index e678250f1333b..91af2923f362b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
@@ -24,27 +24,35 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_sub
 ## 描述
+函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值
+
 ## 语法
 
-`DATETIME SECONDS_SUB(DATETIME date, INT seconds)`
+```sql
+SECONDS_SUB(<datetime>, <seconds>)
+```
+## 参数
+
+| 参数           | 说明                                          |
+|--------------|---------------------------------------------|
+| `<datetime>` | 必填，输入的日期时间值，支持 DATETIME 或 DATE 类型           |
+| `<seconds>`  | 必填，要减少或增加的秒数，支持整数类型（INT）。正数表示增加秒数，负数表示减少秒数。 |
 
-从日期时间或日期减去指定秒数
+## 返回值
+- 返回一个日期时间值，类型与输入的 `<datetime>` 类型一致。
+- 如果 `<datetime>` 为 NULL，函数返回 NULL。
+- 如果 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
 
-参数 date 可以是 DATETIME 或者 DATE 类型，返回类型为 DATETIME。
 
 ## 举例
-
 ```
-mysql> select seconds_sub("2020-01-01 00:00:00", 1);
-+---------------------------------------+
-| seconds_sub('2020-01-01 00:00:00', 1) |
-+---------------------------------------+
-| 2019-12-31 23:59:59                   |
-+---------------------------------------+
+SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
 ```
-
-### keywords
-
-    SECONDS_SUB
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
index ffff53ec059da..68af9a99df6f4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## time_to_sec
 ## 描述
+函数将输入的 `TIME` 或 `DATETIME` 类型的值转换为以秒为单位的总时间。如果输入为 `DATETIME` 类型，函数会自动提取时间部分（`HH:MM:SS`）。
+
 ## 语法
 
-`INT time_to_sec(TIME datetime)`
+```sql
+TIME_TO_SEC(<time>)
+```
+
+## 参数
 
-参数为Datetime类型
-将指定的时间值转为秒数，即返回结果为：小时×3600 + 分钟×60 + 秒。
+| 参数       | 说明                                                          |
+|----------|-------------------------------------------------------------|
+| `<time>` | 必填，支持 TIME 或 DATETIME 类型的值。如果输入为 DATETIME 类型，函数会提取时间部分进行计算。 |
+
+## 返回值
+- 返回一个整数，表示输入时间值转换为总秒数的结果。
+- 如果输入的 `<time>` 为 NULL，函数返回 NULL。
 
 ## 举例
 
+```sql
+SELECT TIME_TO_SEC('16:32:18'),TIME_TO_SEC('2025-01-01 16:32:18');
 ```
-mysql >select current_time(),time_to_sec(current_time());
-+----------------+-----------------------------+
-| current_time() | time_to_sec(current_time()) |
-+----------------+-----------------------------+
-| 16:32:18       |                       59538 |
-+----------------+-----------------------------+
-1 row in set (0.01 sec)
-```
-### keywords
-    TIME_TO_SEC
+```text
++---------------------------------------+--------------------------------------------------+
+| time_to_sec(cast('16:32:18' as TIME)) | time_to_sec(cast('2025-01-01 16:32:18' as TIME)) |
++---------------------------------------+--------------------------------------------------+
+|                                 59538 |                                            59538 |
++---------------------------------------+--------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
index 4b683e9fda1af..c99f01e12b23c 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
@@ -24,25 +24,32 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## sec_to_time
 ## 描述
+`SEC_TO_TIME` 函数将一个以秒为单位的值转换为 `TIME` 类型，返回格式为 `HH:MM:SS`。输入的秒数表示从一天的起点时间（`00:00:00`）开始计算的时间。
 ## 语法
 
-`TIME sec_to_time(INT timestamp)`
+```sql
+SEC_TO_TIME(<seconds>)
+```
 
-参数为INT类型时间戳，函数返回TIME类型时间。
+## 参数
 
-## 举例
+| 参数            | 说明                                                |
+|---------------|---------------------------------------------------|
+| `<seconds>` | 必填，输入的秒数，表示从一天起点时间（00:00:00）开始计算的秒数，支持正整数或负整数类型。 |
 
-```
-mysql >select sec_to_time(time_to_sec(cast('16:32:18' as time)));
-+----------------------------------------------------+
-| sec_to_time(time_to_sec(CAST('16:32:18' AS TIME))) |
-+----------------------------------------------------+
-| 16:32:18                                           |
-+----------------------------------------------------+
-1 row in set (0.53 sec)
-```
+## 返回值
+- 返回一个 TIME 类型值，格式为 `HH:MM:SS`，表示从起点时间（00:00:00）开始计算的时间。
+- 如果输入的 `<seconds>` 为 NULL，函数返回 NULL。
 
-### keywords
-    SEC_TO_TIME
+## 举例
+```sql
+SELECT SEC_TO_TIME(59738);
+```
+```text
++--------------------+
+| sec_to_time(59738) |
++--------------------+
+| 16:35:38           |
++--------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
index 4d18264621096..7562464746357 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_ceil",
+    "title": "SECOND_CEIL",
     "language": "zh-CN"
 }
 ---
@@ -24,39 +24,70 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_ceil
 ## 描述
+函数用于将输入的日期时间值向上对齐到指定的秒周期边界，并返回对齐后的日期时间值。
+
 ## 语法
 
 ```sql
-DATETIME SECOND_CEIL(DATETIME datetime)
-DATETIME SECOND_CEIL(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period, DATETIME origin)
+SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 ```
 
-将日期转化为指定的时间间隔周期的最近上取整时刻。
+## 参数
 
-- datetime：参数是合法的日期表达式。
-- period：参数是指定每个周期有多少秒组成。
-- origin：开始的时间起点，如果不填，默认是 0001-01-01T00:00:00。
+| 参数                  | 说明                                                       |
+|---------------------|----------------------------------------------------------|
+| `<datetime>`        | 必填，输入的日期时间值，支持 DATETIME 类型。                              |
+| `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
+| `<origin_datetime>` | 可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
-## 举例
+## 返回值
+- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
+- 如果输入的 `<datetime>` 为 NULL，返回 NULL。
+- 如果输入的 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），返回 NULL。
 
+## 举例
+只指定参数`<datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56');
+```
+```text
++-----------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++-----------------------------------------------------------+
+| 2025-01-23 12:34:56                                       |
++-----------------------------------------------------------+
 ```
-mysql> select second_ceil("2023-07-13 22:28:18", 5);
+指定参数 `<datetime>`， `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++---------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++---------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                     |
++---------------------------------------------------------------------------------------------------------+
+```
+指定参数 `<datetime>`，`<period>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
+```
+```text
 +--------------------------------------------------------------+
-| second_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +--------------------------------------------------------------+
-| 2023-07-13 22:28:20                                          |
+| 2025-01-23 12:35:00                                          |
 +--------------------------------------------------------------+
-1 row in set (0.01 sec)
 ```
-
-### keywords
-
-    SECOND_CEIL, SECOND, CEIL
-
-### Best Practice
-
-还可参阅 [date_ceil](./date_ceil)
+同时指定   `<datetime>`，`<period>`，`<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++-------------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++-------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:35:00                                                                                         |
++-------------------------------------------------------------------------------------------------------------+
+```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
index bc2abd1465c02..59cfa0d58f67b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_floor",
+    "title": "SECOND_FLOOR",
     "language": "zh-CN"
 }
 ---
@@ -24,39 +24,70 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_floor
 ## 描述
+函数用于将输入的日期时间值向下对齐到指定的秒周期边界，并返回对齐后的日期时间值。
+
 ## 语法
 
 ```sql
-DATETIME SECOND_FLOOR(DATETIME datetime)
-DATETIME SECOND_FLOOR(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period, DATETIME origin)
+SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 ```
 
-将日期转化为指定的时间间隔周期的最近下取整时刻。
+## 参数
 
-- datetime：参数是合法的日期表达式。
-- period：参数是指定每个周期有多少天组成。
-- origin：开始的时间起点，如果不填，默认是 0001-01-01T00:00:00。
+| 参数                  | 说明                                                       |
+|---------------------|----------------------------------------------------------|
+| `<datetime>`        | 必填，输入的日期时间值，支持 DATETIME 类型。                              |
+| `<period>`          | 可选，表示每个周期由多少秒组成，支持正整数类型（INT）。默认为 1 秒。                    |
+| `<origin_datetime>` | 可选，对齐的时间起点，支持 DATETIME 类型。如果未指定，默认为 0001-01-01T00:00:00。 |
 
-## 举例
+## 返回值
+- 返回一个日期时间值，表示输入日期时间向上对齐后的结果。
+- 如果输入的 `<datetime>` 为 NULL，返回 NULL。
+- 如果输入的 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），返回 NULL。
 
+## 举例
+只指定参数`<datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+```
+```text
++------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++------------------------------------------------------------+
+| 2025-01-23 12:34:56                                        |
++------------------------------------------------------------+
+```
+指定参数 `<datetime>`， `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                      |
++----------------------------------------------------------------------------------------------------------+
 ```
-mysql> select second_floor("2023-07-13 22:28:18", 5);
+指定参数 `<datetime>`，`<period>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5);
+```
+```text
 +---------------------------------------------------------------+
-| second_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +---------------------------------------------------------------+
-| 2023-07-13 22:28:15                                           |
+| 2025-01-23 12:34:55                                           |
 +---------------------------------------------------------------+
-1 row in set (0.10 sec)
 ```
-
-### keywords
-
-    SECOND_FLOOR, SECOND, FLOOR
-
-### Best Practice
-
-还可参阅 [date_floor](./date_floor)
+同时指定   `<datetime>`，`<period>`，`<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++--------------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++--------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:50                                                                                          |
++--------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
index 530fa4d66946e..90554d87938ba 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
@@ -24,27 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## Description
+## 描述
+函数用于返回指定日期时间值中的秒数部分。秒数的范围是 0 到 59。
 
+## 语法
 
+```sql
+SECOND(<datetime>)
+```
 
-获得日期中的秒的信息，返回值范围从 0-59。
-
-参数为 Date 或者 Datetime，Time 类型
-
-## Syntax
+## 参数
 
-`INT SECOND(DATETIME date)`
+| 参数           | 说明                                 |
+|--------------|------------------------------------|
+| `<datetime>` | 输入的日期或日期时间值，支持 DATE 或 DATETIME 类型。 |
 
-## Example
+## 返回值
+- 返回一个整数，表示输入日期时间值中的秒数部分，范围为 0 到 59。
+- 如果输入值为 NULL，函数返回 NULL。
+- 如果输入值为非法日期（如 0000-00-00 00:00:00），函数返回 NULL。
 
+## 举例
 ```sql
-mysql> select second('2018-12-31 23:59:59');
-+-----------------------------+
-| second('2018-12-31 23:59:59') |
-+-----------------------------+
-|                          59 |
-+-----------------------------+
+select second('2018-12-31 23:59:59');
 ```
-## Keywords
-    SECOND
+```text
++------------------------------------------------------+
+| second(cast('2018-12-31 23:59:59' as DATETIMEV2(0))) |
++------------------------------------------------------+
+|                                                   59 |
++------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
index bf3ab97f2e741..de68bce3ce0f5 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
@@ -24,27 +24,35 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_add
 ## 描述
+函数用于在指定的日期时间值上增加或减少指定的秒数，并返回计算后的日期时间值
+
 ## 语法
 
-`DATETIME SECONDS_ADD(DATETIME date, INT seconds)`
+```sql
+SECONDS_ADD(<datetime>, <seconds>)
+```
+## 参数
 
-从日期时间或日期加上指定秒数
+| 参数           | 说明                                          |
+|--------------|---------------------------------------------|
+| `<datetime>` | 必填，输入的日期时间值，支持 DATETIME 或 DATE 类型           |
+| `<seconds>`  | 必填，要增加或减少的秒数，支持整数类型（INT）。正数表示增加秒数，负数表示减少秒数。 |
 
-参数 date 可以是 DATETIME 或者 DATE 类型，返回类型为 DATETIME。
+## 返回值
+- 返回一个日期时间值，类型与输入的 `<datetime>` 类型一致。
+- 如果 `<datetime>` 为 NULL，函数返回 NULL。
+- 如果 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
 
-## 举例
 
+## 举例
 ```
-mysql> select seconds_add("2020-02-02 02:02:02", 1);
-+---------------------------------------+
-| seconds_add('2020-02-02 02:02:02', 1) |
-+---------------------------------------+
-| 2020-02-02 02:02:03                   |
-+---------------------------------------+
+SELECT SECONDS_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
 ```
-
-### keywords
-
-    SECONDS_ADD
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
index 4d45fa7047921..0bffe6a394654 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
@@ -24,25 +24,39 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_diff
 ## 描述
-## 语法
-
-`INT seconds_diff(DATETIME enddate, DATETIME startdate)`
+函数用于计算两个日期时间值之间的时间差，以秒为单位返回差值。
 
-开始时间到结束时间相差几秒
 
-## 举例
+## 语法
 
-```
-mysql> select seconds_diff('2020-12-25 22:00:00','2020-12-25 21:00:00');
-+------------------------------------------------------------+
-| seconds_diff('2020-12-25 22:00:00', '2020-12-25 21:00:00') |
-+------------------------------------------------------------+
-|                                                       3600 |
-+------------------------------------------------------------+
+```sql
+SECONDS_DIFF(<end_datetime>, <start_datetime>)
 ```
 
-### keywords
+## 参数
 
-    seconds_diff
+| 参数                 | 说明                                 |
+|--------------------|------------------------------------|
+| `<end_datetime>`   | 必填，结束的日期时间值，支持 DATETIME 或 DATE 类型。 |
+| `<start_datetime>` | 必填，起始的日期时间值，支持 DATETIME 或 DATE 类型。 |
+
+## 返回值
+- 返回一个整数，表示两个日期时间值之间的秒差：
+  - 如果 `<end_datetime>` 晚于 `<start_datetime>`，返回正数。
+  - 如果 `<end_datetime>` 早于 `<start_datetime>`，返回负数。
+  - 如果 `<end_datetime>` 和 `<start_datetime>` 相等，返回 0。
+- 如果任一参数为 NULL，函数返回 NULL。
+- 如果输入的日期时间值为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
+
+## 举例
+```sql
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+|                                                                                                       60 |
++----------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
index e678250f1333b..4f254ab4d8ab7 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
@@ -24,27 +24,35 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_sub
 ## 描述
+函数用于在指定的日期时间值上减少或增加指定的秒数，并返回计算后的日期时间值
+
 ## 语法
 
-`DATETIME SECONDS_SUB(DATETIME date, INT seconds)`
+```sql
+SECONDS_SUB(<datetime>, <seconds>)
+```
+## 参数
 
-从日期时间或日期减去指定秒数
+| 参数           | 说明                                          |
+|--------------|---------------------------------------------|
+| `<datetime>` | 必填，输入的日期时间值，支持 DATETIME 或 DATE 类型           |
+| `<seconds>`  | 必填，要减少或增加的秒数，支持整数类型（INT）。正数表示增加秒数，负数表示减少秒数。 |
 
-参数 date 可以是 DATETIME 或者 DATE 类型，返回类型为 DATETIME。
+## 返回值
+- 返回一个日期时间值，类型与输入的 `<datetime>` 类型一致。
+- 如果 `<datetime>` 为 NULL，函数返回 NULL。
+- 如果 `<datetime>` 为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
 
-## 举例
 
+## 举例
 ```
-mysql> select seconds_sub("2020-01-01 00:00:00", 1);
-+---------------------------------------+
-| seconds_sub('2020-01-01 00:00:00', 1) |
-+---------------------------------------+
-| 2019-12-31 23:59:59                   |
-+---------------------------------------+
+SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
 ```
-
-### keywords
-
-    SECONDS_SUB
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
index ffff53ec059da..68af9a99df6f4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## time_to_sec
 ## 描述
+函数将输入的 `TIME` 或 `DATETIME` 类型的值转换为以秒为单位的总时间。如果输入为 `DATETIME` 类型，函数会自动提取时间部分（`HH:MM:SS`）。
+
 ## 语法
 
-`INT time_to_sec(TIME datetime)`
+```sql
+TIME_TO_SEC(<time>)
+```
+
+## 参数
 
-参数为Datetime类型
-将指定的时间值转为秒数，即返回结果为：小时×3600 + 分钟×60 + 秒。
+| 参数       | 说明                                                          |
+|----------|-------------------------------------------------------------|
+| `<time>` | 必填，支持 TIME 或 DATETIME 类型的值。如果输入为 DATETIME 类型，函数会提取时间部分进行计算。 |
+
+## 返回值
+- 返回一个整数，表示输入时间值转换为总秒数的结果。
+- 如果输入的 `<time>` 为 NULL，函数返回 NULL。
 
 ## 举例
 
+```sql
+SELECT TIME_TO_SEC('16:32:18'),TIME_TO_SEC('2025-01-01 16:32:18');
 ```
-mysql >select current_time(),time_to_sec(current_time());
-+----------------+-----------------------------+
-| current_time() | time_to_sec(current_time()) |
-+----------------+-----------------------------+
-| 16:32:18       |                       59538 |
-+----------------+-----------------------------+
-1 row in set (0.01 sec)
-```
-### keywords
-    TIME_TO_SEC
+```text
++---------------------------------------+--------------------------------------------------+
+| time_to_sec(cast('16:32:18' as TIME)) | time_to_sec(cast('2025-01-01 16:32:18' as TIME)) |
++---------------------------------------+--------------------------------------------------+
+|                                 59538 |                                            59538 |
++---------------------------------------+--------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/sec-to-time.md b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/sec-to-time.md
index c83764cb856fb..375012a2ca75c 100644
--- a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/sec-to-time.md
+++ b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/sec-to-time.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## sec_to_time
-### description
-#### Syntax
+## Description
+The `SEC_TO_TIME` function converts a value in seconds into a `TIME` type, returning the result in the format `HH:MM:SS`.  
+The input seconds represent the time elapsed since the start of a day (`00:00:00`).
 
-`TIME sec_to_time(INT timestamp)`
 
-The parameter is a timestamp of type INT, and the function returns a time of type TIME.
+## Syntax
 
-### example
-
-```
-mysql >select sec_to_time(time_to_sec(cast('16:32:18' as time)));
-+----------------------------------------------------+
-| sec_to_time(time_to_sec(CAST('16:32:18' AS TIME))) |
-+----------------------------------------------------+
-| 16:32:18                                           |
-+----------------------------------------------------+
-1 row in set (0.53 sec)
+```sql
+SEC_TO_TIME(<seconds>)
 ```
+## Parameters
+
+| Parameter     | Description                                                                                                                                           |
+|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<seconds>` | Required. The input number of seconds, representing the time elapsed since the start of a day (00:00:00). Supports positive or negative integers. |
 
-### keywords
-    SEC_TO_TIME
+## Return Value
+- Returns a TIME value in the format `HH:MM:SS`, representing the time calculated from the start of a day (00:00:00).
+- If <seconds> is NULL, the function returns NULL.
+
+## Example
+```sql
+SELECT SEC_TO_TIME(59738);
+```
+```text
++--------------------+
+| sec_to_time(59738) |
++--------------------+
+| 16:35:38           |
++--------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-ceil.md b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-ceil.md
index 8c3fa5cc0ebff..0267059455642 100644
--- a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-ceil.md
+++ b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-ceil.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_ceil",
+    "title": "SECOND_CEIL",
     "language": "en"
 }
 ---
@@ -24,39 +24,69 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_ceil
-### description
-#### Syntax
+## Description
+The function aligns the input datetime value upwards to the nearest second boundary based on the specified period and returns the aligned datetime value.
+
+## Syntax
 
 ```sql
-DATETIME SECOND_CEIL(DATETIME datetime)
-DATETIME SECOND_CEIL(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period, DATETIME origin)
+SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 ```
+## Parameters
 
-Convert the date to the nearest rounding up time of the specified time interval period.
-
-- datetime: a valid date expression.
-- period: specifies how many seconds each cycle consists of.
-- origin: starting from 0001-01-01T00:00:00.
+| Parameter           | Description                                                                                                               |
+|---------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>`        | Required. The input datetime value. Supports the DATETIME type.                                                           |
+| `<period>`          | Optional. Specifies the number of seconds in each period. Supports positive integers (INT). Defaults to 1 second.         |
+| `<origin_datetime>` | Optional. The starting point for alignment. Supports the DATETIME type. Defaults to 0001-01-01T00:00:00 if not specified. |
 
-### example
+## Return Value
+- Returns a datetime value representing the input datetime aligned upwards to the nearest specified second boundary.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
+## Example
+Only specifying `<datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56');
+```
+```text
++-----------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++-----------------------------------------------------------+
+| 2025-01-23 12:34:56                                       |
++-----------------------------------------------------------+
 ```
-mysql> select second_ceil("2023-07-13 22:28:18", 5);
+Specifying `<datetime>` and `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++---------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++---------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                     |
++---------------------------------------------------------------------------------------------------------+
+```
+Specifying `<datetime>` and `<period>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
+```
+```text
 +--------------------------------------------------------------+
-| second_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +--------------------------------------------------------------+
-| 2023-07-13 22:28:20                                          |
+| 2025-01-23 12:35:00                                          |
 +--------------------------------------------------------------+
-1 row in set (0.01 sec)
 ```
-
-### keywords
-
-    SECOND_CEIL, SECOND, CEIL
-
-### Best Practice
-
-See also [date_ceil](./date_ceil)
+Specifying `<datetime>`，`<period>` and `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++-------------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++-------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:35:00                                                                                         |
++-------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-floor.md b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-floor.md
index 4207631f393a8..5e9f420bfdd3e 100644
--- a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-floor.md
+++ b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second-floor.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_floor",
+    "title": "SECOND_FLOOR",
     "language": "en"
 }
 ---
@@ -24,39 +24,69 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_floor
-### description
-#### Syntax
+## Description
+The function aligns the input datetime value upwards to the nearest second boundary based on the specified period and returns the aligned datetime value.
+
+## Syntax
 
 ```sql
-DATETIME SECOND_FLOOR(DATETIME datetime)
-DATETIME SECOND_FLOOR(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period, DATETIME origin)
+SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 ```
+## Parameters
 
-Convert the date to the nearest rounding down time of the specified time interval period.
-
-- datetime: a valid date expression.
-- period: specifies how many seconds each cycle consists of.
-- origin: starting from 0001-01-01T00:00:00.
+| Parameter           | Description                                                                                                               |
+|---------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>`        | Required. The input datetime value. Supports the DATETIME type.                                                           |
+| `<period>`          | Optional. Specifies the number of seconds in each period. Supports positive integers (INT). Defaults to 1 second.         |
+| `<origin_datetime>` | Optional. The starting point for alignment. Supports the DATETIME type. Defaults to 0001-01-01T00:00:00 if not specified. |
 
-### example
+## Return Value
+- Returns a datetime value representing the input datetime aligned upwards to the nearest specified second boundary.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
+## Example
+Only specifying `<datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+```
+```text
++------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++------------------------------------------------------------+
+| 2025-01-23 12:34:56                                        |
++------------------------------------------------------------+
 ```
-mysql> select second_floor("2023-07-13 22:28:18", 5);
+Specifying `<datetime>` and `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                      |
++----------------------------------------------------------------------------------------------------------+
+```
+Specifying `<datetime>` and `<period>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5)
+```
+```text
 +---------------------------------------------------------------+
-| second_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +---------------------------------------------------------------+
-| 2023-07-13 22:28:15                                           |
+| 2025-01-23 12:34:55                                           |
 +---------------------------------------------------------------+
-1 row in set (0.10 sec)
 ```
-
-### keywords
-
-    SECOND_FLOOR, SECOND, FLOOR
-
-### Best Practice
-
-See also [date_floor](./date_floor)
+Specifying `<datetime>`，`<period>` and `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++--------------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++--------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:50                                                                                          |
++--------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second.md b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second.md
index c33853685ecb7..d788ac919357d 100644
--- a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second.md
+++ b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/second.md
@@ -24,25 +24,33 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second
-### description
-#### Syntax
+## Description
+The function returns the second part of the specified datetime value. The range of seconds is 0 to 59.
 
-`INT SECOND(DATETIME date)`
+## Syntax
 
-Returns second information in the time type, ranging from 0,59
+```sql
+SECOND(<datetime>)
+```
+## Parameters
 
-The parameter is Date or Datetime type
+| Parameter    | Description                                                        |
+|--------------|--------------------------------------------------------------------|
+| `<datetime>` | The input date or datetime value. Supports DATE or DATETIME types. |
 
-### example
+## Return Value
+- Returns an integer representing the second part of the input datetime value, ranging from 0 to 59.
+- If the input is NULL, the function returns NULL.
+- If the input is an invalid date (e.g., 0000-00-00 00:00:00), the function returns NULL.
 
+## Example
+```sql
+select second('2018-12-31 23:59:59');
 ```
-mysql> select second('2018-12-31 23:59:59');
-+-----------------------------+
-| second('2018-12-31 23:59:59') |
-+-----------------------------+
-|                          59 |
-+-----------------------------+
-```
-### keywords
-    SECOND
+```text
++---------------------------------------------+
+| second(cast('2018-12-30' as DATETIMEV2(0))) |
++---------------------------------------------+
+|                                           0 |
++---------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-add.md b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-add.md
index dcf5bdfb8ef59..992eb971f3a8c 100644
--- a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-add.md
+++ b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-add.md
@@ -24,27 +24,38 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_add
-### description
-#### Syntax
+## Description
 
-`DATETIME SECONDS_ADD(DATETIME date, INT seconds)`
+The function adds or subtracts a specified number of seconds to/from a given datetime value and returns the resulting
+datetime.
 
-ADD a specified number of seconds from a datetime or date
+## Syntax
 
-The parameter date can be DATETIME or DATE, and the return type is DATETIME.
+```sql
+SECONDS_ADD(<datetime>, <seconds>)
+```
 
-### example
+## Parameters
 
-```
-mysql> select seconds_add("2020-02-02 02:02:02", 1);
-+---------------------------------------+
-| seconds_add('2020-02-02 02:02:02', 1) |
-+---------------------------------------+
-| 2020-02-02 02:02:03                   |
-+---------------------------------------+
-```
+| Parameter    | Description                                                                                                                                         |
+|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>` | Required. The input datetime value. Supports the DATETIME and DATE type.                                                                            |
+| `<seconds>`  | Required. The number of seconds to add or subtract. Supports integers (INT). Positive numbers add seconds, while negative numbers subtract seconds. |
+
+## Return Value
+- Returns a datetime value of the same type as the input <datetime>.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
-### keywords
+## Examples
 
-    SECONDS_ADD
+```
+SELECT SECONDS_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
diff --git a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-diff.md b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-diff.md
index c8e5e5208f3f9..ee2784f0c33e5 100644
--- a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-diff.md
+++ b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-diff.md
@@ -24,25 +24,37 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_diff
-### description
-#### Syntax
+## Description
+The function calculates the time difference between two datetime values and returns the difference in seconds.
 
-`INT seconds_diff(DATETIME enddate, DATETIME startdate)`
-
-The difference between the start time and the end time is seconds
-
-### example
+## Syntax
 
+```sql
+SECONDS_DIFF(<end_datetime>, <start_datetime>)
 ```
-mysql> select seconds_diff('2020-12-25 22:00:00','2020-12-25 21:00:00');
-+------------------------------------------------------------+
-| seconds_diff('2020-12-25 22:00:00', '2020-12-25 21:00:00') |
-+------------------------------------------------------------+
-|                                                       3600 |
-+------------------------------------------------------------+
+## Parameters
+
+| Parameter          | Description                                                                 |
+|--------------------|-----------------------------------------------------------------------------|
+| `<end_datetime>`   | Required. The ending datetime value. Supports the DATETIME and DATE type.   |
+| `<start_datetime>` | Required. The starting datetime value. Supports the DATETIME and DATE type. |
+
+## Return Value
+- Returns an integer representing the difference in seconds between two datetime values:
+    - If `<end_datetime>` is later than `<start_datetime>`, returns a positive value.
+    - If `<end_datetime>` is earlier than `<start_datetime>`, returns a negative value.
+    - If `<end_datetime>` and `<start_datetime>` are equal, returns 0.
+- If either parameter is NULL, the function returns NULL.
+- If the input datetime values are invalid (e.g., 0000-00-00T00:00:00), the function returns NULL.
+
+## Example
+```sql
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+|                                                                                                       60 |
++----------------------------------------------------------------------------------------------------------+
 ```
-
-### keywords
-
-    seconds_diff
diff --git a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-sub.md b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-sub.md
index 6708256636579..50ad5e60d1cf0 100644
--- a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-sub.md
+++ b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/seconds-sub.md
@@ -24,27 +24,38 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_sub
-### description
-#### Syntax
+## Description
 
-`DATETIME SECONDS_SUB(DATETIME date, INT seconds)`
+The function subtracts or adds a specified number of seconds to/from a given datetime value and returns the resulting
+datetime.
 
-Subtracts a specified number of seconds from a datetime or date
+## Syntax
 
-The parameter date can be DATETIME or DATE, and the return type is DATETIME.
+```sql
+SECONDS_SUB(<datetime>, <seconds>)
+```
 
-### example
+## Parameters
 
-```
-mysql> select seconds_sub("2020-01-01 00:00:00", 1);
-+---------------------------------------+
-| seconds_sub('2020-01-01 00:00:00', 1) |
-+---------------------------------------+
-| 2019-12-31 23:59:59                   |
-+---------------------------------------+
-```
+| Parameter    | Description                                                                                                                                         |
+|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>` | Required. The input datetime value. Supports the DATETIME and DATE type.                                                                            |
+| `<seconds>`  | Required. The number of seconds to subtract or add. Supports integers (INT). Positive numbers add seconds, while negative numbers subtract seconds. |
 
-### keywords
+## Return Value
+- Returns a datetime value of the same type as the input <datetime>.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
-    SECONDS_SUB
+## Examples
+
+```
+SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/time-to-sec.md b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/time-to-sec.md
index f0ac58826eca8..f405043ec3e4d 100644
--- a/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/time-to-sec.md
+++ b/versioned_docs/version-2.0/sql-manual/sql-functions/date-time-functions/time-to-sec.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## time_to_sec
-### description
-#### Syntax
+## Description
+The function converts an input `TIME` or `DATETIME` value into the total time in seconds. If the input is of `DATETIME` type, the function automatically extracts the time part (`HH:MM:SS`).
 
-`INT time_to_sec(TIME datetime)`
 
-input parameter is the time type
-Convert the specified time value to seconds, returned result is: hours × 3600+ minutes×60 + seconds.
-
-### example
+## Syntax
 
+```sql
+TIME_TO_SEC(<time>)
 ```
-mysql >select current_time(),time_to_sec(current_time());
-+----------------+-----------------------------+
-| current_time() | time_to_sec(current_time()) |
-+----------------+-----------------------------+
-| 16:32:18       |                       59538 |
-+----------------+-----------------------------+
-1 row in set (0.01 sec)
+## Parameters
+
+| Parameter | Description                                                                                                                |
+|-----------|----------------------------------------------------------------------------------------------------------------------------|
+| `<time>`  | Required. Supports TIME or DATETIME values. If the input is DATETIME, the function extracts the time part for calculation. |
+
+## Return Value
+- Returns an integer representing the total seconds of the input time value.
+- If <time> is NULL, the function returns NULL.
+
+## Example
+
+```sql
+SELECT TIME_TO_SEC('16:32:18'),TIME_TO_SEC('2025-01-01 16:32:18');
 ```
-### keywords
-    TIME_TO_SEC
+```text
++---------------------------------------+--------------------------------------------------+
+| time_to_sec(cast('16:32:18' as TIME)) | time_to_sec(cast('2025-01-01 16:32:18' as TIME)) |
++---------------------------------------+--------------------------------------------------+
+|                                 59538 |                                            59538 |
++---------------------------------------+--------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
index c83764cb856fb..375012a2ca75c 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## sec_to_time
-### description
-#### Syntax
+## Description
+The `SEC_TO_TIME` function converts a value in seconds into a `TIME` type, returning the result in the format `HH:MM:SS`.  
+The input seconds represent the time elapsed since the start of a day (`00:00:00`).
 
-`TIME sec_to_time(INT timestamp)`
 
-The parameter is a timestamp of type INT, and the function returns a time of type TIME.
+## Syntax
 
-### example
-
-```
-mysql >select sec_to_time(time_to_sec(cast('16:32:18' as time)));
-+----------------------------------------------------+
-| sec_to_time(time_to_sec(CAST('16:32:18' AS TIME))) |
-+----------------------------------------------------+
-| 16:32:18                                           |
-+----------------------------------------------------+
-1 row in set (0.53 sec)
+```sql
+SEC_TO_TIME(<seconds>)
 ```
+## Parameters
+
+| Parameter     | Description                                                                                                                                           |
+|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<seconds>` | Required. The input number of seconds, representing the time elapsed since the start of a day (00:00:00). Supports positive or negative integers. |
 
-### keywords
-    SEC_TO_TIME
+## Return Value
+- Returns a TIME value in the format `HH:MM:SS`, representing the time calculated from the start of a day (00:00:00).
+- If <seconds> is NULL, the function returns NULL.
+
+## Example
+```sql
+SELECT SEC_TO_TIME(59738);
+```
+```text
++--------------------+
+| sec_to_time(59738) |
++--------------------+
+| 16:35:38           |
++--------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
index 8c3fa5cc0ebff..0267059455642 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_ceil",
+    "title": "SECOND_CEIL",
     "language": "en"
 }
 ---
@@ -24,39 +24,69 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_ceil
-### description
-#### Syntax
+## Description
+The function aligns the input datetime value upwards to the nearest second boundary based on the specified period and returns the aligned datetime value.
+
+## Syntax
 
 ```sql
-DATETIME SECOND_CEIL(DATETIME datetime)
-DATETIME SECOND_CEIL(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period, DATETIME origin)
+SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 ```
+## Parameters
 
-Convert the date to the nearest rounding up time of the specified time interval period.
-
-- datetime: a valid date expression.
-- period: specifies how many seconds each cycle consists of.
-- origin: starting from 0001-01-01T00:00:00.
+| Parameter           | Description                                                                                                               |
+|---------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>`        | Required. The input datetime value. Supports the DATETIME type.                                                           |
+| `<period>`          | Optional. Specifies the number of seconds in each period. Supports positive integers (INT). Defaults to 1 second.         |
+| `<origin_datetime>` | Optional. The starting point for alignment. Supports the DATETIME type. Defaults to 0001-01-01T00:00:00 if not specified. |
 
-### example
+## Return Value
+- Returns a datetime value representing the input datetime aligned upwards to the nearest specified second boundary.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
+## Example
+Only specifying `<datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56');
+```
+```text
++-----------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++-----------------------------------------------------------+
+| 2025-01-23 12:34:56                                       |
++-----------------------------------------------------------+
 ```
-mysql> select second_ceil("2023-07-13 22:28:18", 5);
+Specifying `<datetime>` and `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++---------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++---------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                     |
++---------------------------------------------------------------------------------------------------------+
+```
+Specifying `<datetime>` and `<period>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
+```
+```text
 +--------------------------------------------------------------+
-| second_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +--------------------------------------------------------------+
-| 2023-07-13 22:28:20                                          |
+| 2025-01-23 12:35:00                                          |
 +--------------------------------------------------------------+
-1 row in set (0.01 sec)
 ```
-
-### keywords
-
-    SECOND_CEIL, SECOND, CEIL
-
-### Best Practice
-
-See also [date_ceil](./date_ceil)
+Specifying `<datetime>`，`<period>` and `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++-------------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++-------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:35:00                                                                                         |
++-------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
index 4207631f393a8..5e9f420bfdd3e 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_floor",
+    "title": "SECOND_FLOOR",
     "language": "en"
 }
 ---
@@ -24,39 +24,69 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_floor
-### description
-#### Syntax
+## Description
+The function aligns the input datetime value upwards to the nearest second boundary based on the specified period and returns the aligned datetime value.
+
+## Syntax
 
 ```sql
-DATETIME SECOND_FLOOR(DATETIME datetime)
-DATETIME SECOND_FLOOR(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period, DATETIME origin)
+SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 ```
+## Parameters
 
-Convert the date to the nearest rounding down time of the specified time interval period.
-
-- datetime: a valid date expression.
-- period: specifies how many seconds each cycle consists of.
-- origin: starting from 0001-01-01T00:00:00.
+| Parameter           | Description                                                                                                               |
+|---------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>`        | Required. The input datetime value. Supports the DATETIME type.                                                           |
+| `<period>`          | Optional. Specifies the number of seconds in each period. Supports positive integers (INT). Defaults to 1 second.         |
+| `<origin_datetime>` | Optional. The starting point for alignment. Supports the DATETIME type. Defaults to 0001-01-01T00:00:00 if not specified. |
 
-### example
+## Return Value
+- Returns a datetime value representing the input datetime aligned upwards to the nearest specified second boundary.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
+## Example
+Only specifying `<datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+```
+```text
++------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++------------------------------------------------------------+
+| 2025-01-23 12:34:56                                        |
++------------------------------------------------------------+
 ```
-mysql> select second_floor("2023-07-13 22:28:18", 5);
+Specifying `<datetime>` and `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                      |
++----------------------------------------------------------------------------------------------------------+
+```
+Specifying `<datetime>` and `<period>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5)
+```
+```text
 +---------------------------------------------------------------+
-| second_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +---------------------------------------------------------------+
-| 2023-07-13 22:28:15                                           |
+| 2025-01-23 12:34:55                                           |
 +---------------------------------------------------------------+
-1 row in set (0.10 sec)
 ```
-
-### keywords
-
-    SECOND_FLOOR, SECOND, FLOOR
-
-### Best Practice
-
-See also [date_floor](./date_floor)
+Specifying `<datetime>`，`<period>` and `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++--------------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++--------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:50                                                                                          |
++--------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
index cbe73597cfed9..d788ac919357d 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
@@ -25,23 +25,32 @@ under the License.
 -->
 
 ## Description
+The function returns the second part of the specified datetime value. The range of seconds is 0 to 59.
 
-Returns second information in the time type, ranging from 0,59
+## Syntax
+
+```sql
+SECOND(<datetime>)
+```
+## Parameters
 
-The parameter is Date or Datetime or Time type
+| Parameter    | Description                                                        |
+|--------------|--------------------------------------------------------------------|
+| `<datetime>` | The input date or datetime value. Supports DATE or DATETIME types. |
 
-## Syntax
-`INT SECOND(DATETIME date)`
+## Return Value
+- Returns an integer representing the second part of the input datetime value, ranging from 0 to 59.
+- If the input is NULL, the function returns NULL.
+- If the input is an invalid date (e.g., 0000-00-00 00:00:00), the function returns NULL.
 
 ## Example
-
 ```sql
-mysql> select second('2018-12-31 23:59:59');
-+-----------------------------+
-| second('2018-12-31 23:59:59') |
-+-----------------------------+
-|                          59 |
-+-----------------------------+
+select second('2018-12-31 23:59:59');
 ```
-## Keywords
-    SECOND
+```text
++---------------------------------------------+
+| second(cast('2018-12-30' as DATETIMEV2(0))) |
++---------------------------------------------+
+|                                           0 |
++---------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
index dcf5bdfb8ef59..992eb971f3a8c 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
@@ -24,27 +24,38 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_add
-### description
-#### Syntax
+## Description
 
-`DATETIME SECONDS_ADD(DATETIME date, INT seconds)`
+The function adds or subtracts a specified number of seconds to/from a given datetime value and returns the resulting
+datetime.
 
-ADD a specified number of seconds from a datetime or date
+## Syntax
 
-The parameter date can be DATETIME or DATE, and the return type is DATETIME.
+```sql
+SECONDS_ADD(<datetime>, <seconds>)
+```
 
-### example
+## Parameters
 
-```
-mysql> select seconds_add("2020-02-02 02:02:02", 1);
-+---------------------------------------+
-| seconds_add('2020-02-02 02:02:02', 1) |
-+---------------------------------------+
-| 2020-02-02 02:02:03                   |
-+---------------------------------------+
-```
+| Parameter    | Description                                                                                                                                         |
+|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>` | Required. The input datetime value. Supports the DATETIME and DATE type.                                                                            |
+| `<seconds>`  | Required. The number of seconds to add or subtract. Supports integers (INT). Positive numbers add seconds, while negative numbers subtract seconds. |
+
+## Return Value
+- Returns a datetime value of the same type as the input <datetime>.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
-### keywords
+## Examples
 
-    SECONDS_ADD
+```
+SELECT SECONDS_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
index c8e5e5208f3f9..ee2784f0c33e5 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
@@ -24,25 +24,37 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_diff
-### description
-#### Syntax
+## Description
+The function calculates the time difference between two datetime values and returns the difference in seconds.
 
-`INT seconds_diff(DATETIME enddate, DATETIME startdate)`
-
-The difference between the start time and the end time is seconds
-
-### example
+## Syntax
 
+```sql
+SECONDS_DIFF(<end_datetime>, <start_datetime>)
 ```
-mysql> select seconds_diff('2020-12-25 22:00:00','2020-12-25 21:00:00');
-+------------------------------------------------------------+
-| seconds_diff('2020-12-25 22:00:00', '2020-12-25 21:00:00') |
-+------------------------------------------------------------+
-|                                                       3600 |
-+------------------------------------------------------------+
+## Parameters
+
+| Parameter          | Description                                                                 |
+|--------------------|-----------------------------------------------------------------------------|
+| `<end_datetime>`   | Required. The ending datetime value. Supports the DATETIME and DATE type.   |
+| `<start_datetime>` | Required. The starting datetime value. Supports the DATETIME and DATE type. |
+
+## Return Value
+- Returns an integer representing the difference in seconds between two datetime values:
+    - If `<end_datetime>` is later than `<start_datetime>`, returns a positive value.
+    - If `<end_datetime>` is earlier than `<start_datetime>`, returns a negative value.
+    - If `<end_datetime>` and `<start_datetime>` are equal, returns 0.
+- If either parameter is NULL, the function returns NULL.
+- If the input datetime values are invalid (e.g., 0000-00-00T00:00:00), the function returns NULL.
+
+## Example
+```sql
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+|                                                                                                       60 |
++----------------------------------------------------------------------------------------------------------+
 ```
-
-### keywords
-
-    seconds_diff
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
index 6708256636579..50ad5e60d1cf0 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
@@ -24,27 +24,38 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_sub
-### description
-#### Syntax
+## Description
 
-`DATETIME SECONDS_SUB(DATETIME date, INT seconds)`
+The function subtracts or adds a specified number of seconds to/from a given datetime value and returns the resulting
+datetime.
 
-Subtracts a specified number of seconds from a datetime or date
+## Syntax
 
-The parameter date can be DATETIME or DATE, and the return type is DATETIME.
+```sql
+SECONDS_SUB(<datetime>, <seconds>)
+```
 
-### example
+## Parameters
 
-```
-mysql> select seconds_sub("2020-01-01 00:00:00", 1);
-+---------------------------------------+
-| seconds_sub('2020-01-01 00:00:00', 1) |
-+---------------------------------------+
-| 2019-12-31 23:59:59                   |
-+---------------------------------------+
-```
+| Parameter    | Description                                                                                                                                         |
+|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>` | Required. The input datetime value. Supports the DATETIME and DATE type.                                                                            |
+| `<seconds>`  | Required. The number of seconds to subtract or add. Supports integers (INT). Positive numbers add seconds, while negative numbers subtract seconds. |
 
-### keywords
+## Return Value
+- Returns a datetime value of the same type as the input <datetime>.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
-    SECONDS_SUB
+## Examples
+
+```
+SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
index f0ac58826eca8..f405043ec3e4d 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## time_to_sec
-### description
-#### Syntax
+## Description
+The function converts an input `TIME` or `DATETIME` value into the total time in seconds. If the input is of `DATETIME` type, the function automatically extracts the time part (`HH:MM:SS`).
 
-`INT time_to_sec(TIME datetime)`
 
-input parameter is the time type
-Convert the specified time value to seconds, returned result is: hours × 3600+ minutes×60 + seconds.
-
-### example
+## Syntax
 
+```sql
+TIME_TO_SEC(<time>)
 ```
-mysql >select current_time(),time_to_sec(current_time());
-+----------------+-----------------------------+
-| current_time() | time_to_sec(current_time()) |
-+----------------+-----------------------------+
-| 16:32:18       |                       59538 |
-+----------------+-----------------------------+
-1 row in set (0.01 sec)
+## Parameters
+
+| Parameter | Description                                                                                                                |
+|-----------|----------------------------------------------------------------------------------------------------------------------------|
+| `<time>`  | Required. Supports TIME or DATETIME values. If the input is DATETIME, the function extracts the time part for calculation. |
+
+## Return Value
+- Returns an integer representing the total seconds of the input time value.
+- If <time> is NULL, the function returns NULL.
+
+## Example
+
+```sql
+SELECT TIME_TO_SEC('16:32:18'),TIME_TO_SEC('2025-01-01 16:32:18');
 ```
-### keywords
-    TIME_TO_SEC
+```text
++---------------------------------------+--------------------------------------------------+
+| time_to_sec(cast('16:32:18' as TIME)) | time_to_sec(cast('2025-01-01 16:32:18' as TIME)) |
++---------------------------------------+--------------------------------------------------+
+|                                 59538 |                                            59538 |
++---------------------------------------+--------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
index c83764cb856fb..375012a2ca75c 100644
--- a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
+++ b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/sec-to-time.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## sec_to_time
-### description
-#### Syntax
+## Description
+The `SEC_TO_TIME` function converts a value in seconds into a `TIME` type, returning the result in the format `HH:MM:SS`.  
+The input seconds represent the time elapsed since the start of a day (`00:00:00`).
 
-`TIME sec_to_time(INT timestamp)`
 
-The parameter is a timestamp of type INT, and the function returns a time of type TIME.
+## Syntax
 
-### example
-
-```
-mysql >select sec_to_time(time_to_sec(cast('16:32:18' as time)));
-+----------------------------------------------------+
-| sec_to_time(time_to_sec(CAST('16:32:18' AS TIME))) |
-+----------------------------------------------------+
-| 16:32:18                                           |
-+----------------------------------------------------+
-1 row in set (0.53 sec)
+```sql
+SEC_TO_TIME(<seconds>)
 ```
+## Parameters
+
+| Parameter     | Description                                                                                                                                           |
+|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<seconds>` | Required. The input number of seconds, representing the time elapsed since the start of a day (00:00:00). Supports positive or negative integers. |
 
-### keywords
-    SEC_TO_TIME
+## Return Value
+- Returns a TIME value in the format `HH:MM:SS`, representing the time calculated from the start of a day (00:00:00).
+- If <seconds> is NULL, the function returns NULL.
+
+## Example
+```sql
+SELECT SEC_TO_TIME(59738);
+```
+```text
++--------------------+
+| sec_to_time(59738) |
++--------------------+
+| 16:35:38           |
++--------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
index 8c3fa5cc0ebff..0267059455642 100644
--- a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
+++ b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-ceil.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_ceil",
+    "title": "SECOND_CEIL",
     "language": "en"
 }
 ---
@@ -24,39 +24,69 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_ceil
-### description
-#### Syntax
+## Description
+The function aligns the input datetime value upwards to the nearest second boundary based on the specified period and returns the aligned datetime value.
+
+## Syntax
 
 ```sql
-DATETIME SECOND_CEIL(DATETIME datetime)
-DATETIME SECOND_CEIL(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period)
-DATETIME SECOND_CEIL(DATETIME datetime, INT period, DATETIME origin)
+SECOND_CEIL(<datetime>[, <period>][, <origin_datetime>])
 ```
+## Parameters
 
-Convert the date to the nearest rounding up time of the specified time interval period.
-
-- datetime: a valid date expression.
-- period: specifies how many seconds each cycle consists of.
-- origin: starting from 0001-01-01T00:00:00.
+| Parameter           | Description                                                                                                               |
+|---------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>`        | Required. The input datetime value. Supports the DATETIME type.                                                           |
+| `<period>`          | Optional. Specifies the number of seconds in each period. Supports positive integers (INT). Defaults to 1 second.         |
+| `<origin_datetime>` | Optional. The starting point for alignment. Supports the DATETIME type. Defaults to 0001-01-01T00:00:00 if not specified. |
 
-### example
+## Return Value
+- Returns a datetime value representing the input datetime aligned upwards to the nearest specified second boundary.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
+## Example
+Only specifying `<datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56');
+```
+```text
++-----------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++-----------------------------------------------------------+
+| 2025-01-23 12:34:56                                       |
++-----------------------------------------------------------+
 ```
-mysql> select second_ceil("2023-07-13 22:28:18", 5);
+Specifying `<datetime>` and `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++---------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++---------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                     |
++---------------------------------------------------------------------------------------------------------+
+```
+Specifying `<datetime>` and `<period>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 5)
+```
+```text
 +--------------------------------------------------------------+
-| second_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +--------------------------------------------------------------+
-| 2023-07-13 22:28:20                                          |
+| 2025-01-23 12:35:00                                          |
 +--------------------------------------------------------------+
-1 row in set (0.01 sec)
 ```
-
-### keywords
-
-    SECOND_CEIL, SECOND, CEIL
-
-### Best Practice
-
-See also [date_ceil](./date_ceil)
+Specifying `<datetime>`，`<period>` and `<origin_datetime>`
+```sql
+SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++-------------------------------------------------------------------------------------------------------------+
+| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++-------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:35:00                                                                                         |
++-------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
index 4207631f393a8..5e9f420bfdd3e 100644
--- a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
+++ b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second-floor.md
@@ -1,6 +1,6 @@
 ---
 {
-    "title": "second_floor",
+    "title": "SECOND_FLOOR",
     "language": "en"
 }
 ---
@@ -24,39 +24,69 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## second_floor
-### description
-#### Syntax
+## Description
+The function aligns the input datetime value upwards to the nearest second boundary based on the specified period and returns the aligned datetime value.
+
+## Syntax
 
 ```sql
-DATETIME SECOND_FLOOR(DATETIME datetime)
-DATETIME SECOND_FLOOR(DATETIME datetime, DATETIME origin)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period)
-DATETIME SECOND_FLOOR(DATETIME datetime, INT period, DATETIME origin)
+SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])
 ```
+## Parameters
 
-Convert the date to the nearest rounding down time of the specified time interval period.
-
-- datetime: a valid date expression.
-- period: specifies how many seconds each cycle consists of.
-- origin: starting from 0001-01-01T00:00:00.
+| Parameter           | Description                                                                                                               |
+|---------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>`        | Required. The input datetime value. Supports the DATETIME type.                                                           |
+| `<period>`          | Optional. Specifies the number of seconds in each period. Supports positive integers (INT). Defaults to 1 second.         |
+| `<origin_datetime>` | Optional. The starting point for alignment. Supports the DATETIME type. Defaults to 0001-01-01T00:00:00 if not specified. |
 
-### example
+## Return Value
+- Returns a datetime value representing the input datetime aligned upwards to the nearest specified second boundary.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
+## Example
+Only specifying `<datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+```
+```text
++------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++------------------------------------------------------------+
+| 2025-01-23 12:34:56                                        |
++------------------------------------------------------------+
 ```
-mysql> select second_floor("2023-07-13 22:28:18", 5);
+Specifying `<datetime>` and `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:56                                                                                      |
++----------------------------------------------------------------------------------------------------------+
+```
+Specifying `<datetime>` and `<period>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5)
+```
+```text
 +---------------------------------------------------------------+
-| second_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
 +---------------------------------------------------------------+
-| 2023-07-13 22:28:15                                           |
+| 2025-01-23 12:34:55                                           |
 +---------------------------------------------------------------+
-1 row in set (0.10 sec)
 ```
-
-### keywords
-
-    SECOND_FLOOR, SECOND, FLOOR
-
-### Best Practice
-
-See also [date_floor](./date_floor)
+Specifying `<datetime>`，`<period>` and `<origin_datetime>`
+```sql
+SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+```
+```text
++--------------------------------------------------------------------------------------------------------------+
+| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
++--------------------------------------------------------------------------------------------------------------+
+| 2025-01-23 12:34:50                                                                                          |
++--------------------------------------------------------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
index cbe73597cfed9..d788ac919357d 100644
--- a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
+++ b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/second.md
@@ -25,23 +25,32 @@ under the License.
 -->
 
 ## Description
+The function returns the second part of the specified datetime value. The range of seconds is 0 to 59.
 
-Returns second information in the time type, ranging from 0,59
+## Syntax
+
+```sql
+SECOND(<datetime>)
+```
+## Parameters
 
-The parameter is Date or Datetime or Time type
+| Parameter    | Description                                                        |
+|--------------|--------------------------------------------------------------------|
+| `<datetime>` | The input date or datetime value. Supports DATE or DATETIME types. |
 
-## Syntax
-`INT SECOND(DATETIME date)`
+## Return Value
+- Returns an integer representing the second part of the input datetime value, ranging from 0 to 59.
+- If the input is NULL, the function returns NULL.
+- If the input is an invalid date (e.g., 0000-00-00 00:00:00), the function returns NULL.
 
 ## Example
-
 ```sql
-mysql> select second('2018-12-31 23:59:59');
-+-----------------------------+
-| second('2018-12-31 23:59:59') |
-+-----------------------------+
-|                          59 |
-+-----------------------------+
+select second('2018-12-31 23:59:59');
 ```
-## Keywords
-    SECOND
+```text
++---------------------------------------------+
+| second(cast('2018-12-30' as DATETIMEV2(0))) |
++---------------------------------------------+
+|                                           0 |
++---------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
index dcf5bdfb8ef59..992eb971f3a8c 100644
--- a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
+++ b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-add.md
@@ -24,27 +24,38 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_add
-### description
-#### Syntax
+## Description
 
-`DATETIME SECONDS_ADD(DATETIME date, INT seconds)`
+The function adds or subtracts a specified number of seconds to/from a given datetime value and returns the resulting
+datetime.
 
-ADD a specified number of seconds from a datetime or date
+## Syntax
 
-The parameter date can be DATETIME or DATE, and the return type is DATETIME.
+```sql
+SECONDS_ADD(<datetime>, <seconds>)
+```
 
-### example
+## Parameters
 
-```
-mysql> select seconds_add("2020-02-02 02:02:02", 1);
-+---------------------------------------+
-| seconds_add('2020-02-02 02:02:02', 1) |
-+---------------------------------------+
-| 2020-02-02 02:02:03                   |
-+---------------------------------------+
-```
+| Parameter    | Description                                                                                                                                         |
+|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>` | Required. The input datetime value. Supports the DATETIME and DATE type.                                                                            |
+| `<seconds>`  | Required. The number of seconds to add or subtract. Supports integers (INT). Positive numbers add seconds, while negative numbers subtract seconds. |
+
+## Return Value
+- Returns a datetime value of the same type as the input <datetime>.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
-### keywords
+## Examples
 
-    SECONDS_ADD
+```
+SELECT SECONDS_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
diff --git a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
index c8e5e5208f3f9..ee2784f0c33e5 100644
--- a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
+++ b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md
@@ -24,25 +24,37 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_diff
-### description
-#### Syntax
+## Description
+The function calculates the time difference between two datetime values and returns the difference in seconds.
 
-`INT seconds_diff(DATETIME enddate, DATETIME startdate)`
-
-The difference between the start time and the end time is seconds
-
-### example
+## Syntax
 
+```sql
+SECONDS_DIFF(<end_datetime>, <start_datetime>)
 ```
-mysql> select seconds_diff('2020-12-25 22:00:00','2020-12-25 21:00:00');
-+------------------------------------------------------------+
-| seconds_diff('2020-12-25 22:00:00', '2020-12-25 21:00:00') |
-+------------------------------------------------------------+
-|                                                       3600 |
-+------------------------------------------------------------+
+## Parameters
+
+| Parameter          | Description                                                                 |
+|--------------------|-----------------------------------------------------------------------------|
+| `<end_datetime>`   | Required. The ending datetime value. Supports the DATETIME and DATE type.   |
+| `<start_datetime>` | Required. The starting datetime value. Supports the DATETIME and DATE type. |
+
+## Return Value
+- Returns an integer representing the difference in seconds between two datetime values:
+    - If `<end_datetime>` is later than `<start_datetime>`, returns a positive value.
+    - If `<end_datetime>` is earlier than `<start_datetime>`, returns a negative value.
+    - If `<end_datetime>` and `<start_datetime>` are equal, returns 0.
+- If either parameter is NULL, the function returns NULL.
+- If the input datetime values are invalid (e.g., 0000-00-00T00:00:00), the function returns NULL.
+
+## Example
+```sql
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56');
+```
+```text
++----------------------------------------------------------------------------------------------------------+
+| seconds_diff(cast('2025-01-23 12:35:56' as DATETIMEV2(0)), cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
++----------------------------------------------------------------------------------------------------------+
+|                                                                                                       60 |
++----------------------------------------------------------------------------------------------------------+
 ```
-
-### keywords
-
-    seconds_diff
diff --git a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
index 6708256636579..50ad5e60d1cf0 100644
--- a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
+++ b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-sub.md
@@ -24,27 +24,38 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## seconds_sub
-### description
-#### Syntax
+## Description
 
-`DATETIME SECONDS_SUB(DATETIME date, INT seconds)`
+The function subtracts or adds a specified number of seconds to/from a given datetime value and returns the resulting
+datetime.
 
-Subtracts a specified number of seconds from a datetime or date
+## Syntax
 
-The parameter date can be DATETIME or DATE, and the return type is DATETIME.
+```sql
+SECONDS_SUB(<datetime>, <seconds>)
+```
 
-### example
+## Parameters
 
-```
-mysql> select seconds_sub("2020-01-01 00:00:00", 1);
-+---------------------------------------+
-| seconds_sub('2020-01-01 00:00:00', 1) |
-+---------------------------------------+
-| 2019-12-31 23:59:59                   |
-+---------------------------------------+
-```
+| Parameter    | Description                                                                                                                                         |
+|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+| `<datetime>` | Required. The input datetime value. Supports the DATETIME and DATE type.                                                                            |
+| `<seconds>`  | Required. The number of seconds to subtract or add. Supports integers (INT). Positive numbers add seconds, while negative numbers subtract seconds. |
 
-### keywords
+## Return Value
+- Returns a datetime value of the same type as the input <datetime>.
+- If `<datetime>` is NULL, the function returns NULL.
+- If `<datetime>` is an invalid date (e.g., 0000-00-00T00:00:00), the function returns NULL.
 
-    SECONDS_SUB
+## Examples
+
+```
+SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
+```
+```text
++---------------------------------------------------------------+----------------------------------------------------------------+
+| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
++---------------------------------------------------------------+----------------------------------------------------------------+
+| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
++---------------------------------------------------------------+----------------------------------------------------------------+
+```
\ No newline at end of file
diff --git a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
index f0ac58826eca8..f405043ec3e4d 100644
--- a/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
+++ b/versioned_docs/version-3.0/sql-manual/sql-functions/scalar-functions/date-time-functions/time-to-sec.md
@@ -24,25 +24,34 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-## time_to_sec
-### description
-#### Syntax
+## Description
+The function converts an input `TIME` or `DATETIME` value into the total time in seconds. If the input is of `DATETIME` type, the function automatically extracts the time part (`HH:MM:SS`).
 
-`INT time_to_sec(TIME datetime)`
 
-input parameter is the time type
-Convert the specified time value to seconds, returned result is: hours × 3600+ minutes×60 + seconds.
-
-### example
+## Syntax
 
+```sql
+TIME_TO_SEC(<time>)
 ```
-mysql >select current_time(),time_to_sec(current_time());
-+----------------+-----------------------------+
-| current_time() | time_to_sec(current_time()) |
-+----------------+-----------------------------+
-| 16:32:18       |                       59538 |
-+----------------+-----------------------------+
-1 row in set (0.01 sec)
+## Parameters
+
+| Parameter | Description                                                                                                                |
+|-----------|----------------------------------------------------------------------------------------------------------------------------|
+| `<time>`  | Required. Supports TIME or DATETIME values. If the input is DATETIME, the function extracts the time part for calculation. |
+
+## Return Value
+- Returns an integer representing the total seconds of the input time value.
+- If <time> is NULL, the function returns NULL.
+
+## Example
+
+```sql
+SELECT TIME_TO_SEC('16:32:18'),TIME_TO_SEC('2025-01-01 16:32:18');
 ```
-### keywords
-    TIME_TO_SEC
+```text
++---------------------------------------+--------------------------------------------------+
+| time_to_sec(cast('16:32:18' as TIME)) | time_to_sec(cast('2025-01-01 16:32:18' as TIME)) |
++---------------------------------------+--------------------------------------------------+
+|                                 59538 |                                            59538 |
++---------------------------------------+--------------------------------------------------+
+```
\ No newline at end of file