zclllyybb commented on code in PR #2816:
URL: https://github.com/apache/doris-website/pull/2816#discussion_r2378164291
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/seconds-diff.md:
##########
@@ -7,38 +7,72 @@
## 描述
-函数用于计算两个日期时间值之间的时间差，以秒为单位返回差值。
+SECONDS_DIFF 函数用于计算两个日期时间值之间的差值，并以秒为单位返回结果。该函数支持处理 DATE、DATETIME 类型，若输入为 DATE
类型，默认其时间部分为 00:00:00。
## 语法
```sql
-SECONDS_DIFF(<end_datetime>, <start_datetime>)
+SECONDS_DIFF(<date_or_time_expr1>, <date_or_time_expr2>)
```
## 参数
| 参数 | 说明 |
|--------------------|------------------------------------|
-| `<end_datetime>` | 必填，结束的日期时间值，支持 DATETIME 或 DATE 类型。 |
-| `<start_datetime>` | 必填，起始的日期时间值，支持 DATETIME 或 DATE 类型。 |
+| `<date_or_time_expr1>` | 必填，结束的日期时间值，类型可以是 DATE、DATETIME，具体 datetime/date
请查看 [datetime
的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion),
[date
的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)
|
+| `<date_or_time_expr2>` | 必填，起始的日期时间值，类型可以是 DATE、DATETIME。。 |
## 返回值
-- 返回一个整数，表示两个日期时间值之间的秒差：
- - 如果 `<end_datetime>` 晚于 `<start_datetime>`，返回正数。
- - 如果 `<end_datetime>` 早于 `<start_datetime>`，返回负数。
- - 如果 `<end_datetime>` 和 `<start_datetime>` 相等，返回 0。
-- 如果任一参数为 NULL，函数返回 NULL。
-- 如果输入的日期时间值为非法日期（如 0000-00-00T00:00:00），函数返回 NULL。
+
+返回类型为 BIGINT，表示两个日期时间之间的秒数差：
+
+- 若 <date_or_time_expr1> 晚于 <date_or_time_expr2>，返回正数；
+- 若 <date_or_time_expr1> 早于 <date_or_time_expr2>，返回负数；
+- 若两个时间相等，返回 0；
+- 若任一参数为 NULL，返回 NULL；
+- 包含 scale 的时间,会把小数部分差距算入
## 举例
```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 |
-+----------------------------------------------------------------------------------------------------------+
+--- 同一小时内的秒差
+SELECT SECONDS_DIFF('2025-01-23 12:35:56', '2025-01-23 12:34:56') AS result;
++--------+
+| result |
++--------+
+| 60 |
++--------+
+
+
+--- 结束时间早于起始时间（返回负数）
+SELECT SECONDS_DIFF('2023-01-01 00:00:00', '2023-01-01 00:01:00') AS result;
++--------+
+| result |
++--------+
+| -60 |
++--------+
+
+--- 输入为 DATE 类型（默认时间 00:00:00）
+SELECT SECONDS_DIFF('2023-01-02', '2023-01-01') AS result; -- 相差1天（86400秒）
++--------+
+| result |
++--------+
+| 86400 |
++--------+
+
+--- 包含 scale 的时间,会把小数部分差距算入
+SELECT SECONDS_DIFF('2023-07-13 12:00:00.123', '2023-07-13 11:59:59') AS
result;
Review Comment:
这个例子不恰当，本来不带小数也是1秒
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
