zclllyybb commented on code in PR #2694:
URL: https://github.com/apache/doris-website/pull/2694#discussion_r2249363116
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/convert-tz.md:
##########
@@ -20,38 +19,88 @@ CONVERT_TZ(<dt>, <from_tz>, <to_tz>)
| 参数 | 说明 |
| -- | -- |
-| `<dt>` | 需要被转换的 datetime 值 |
-| `<from_tz>` | dt 的原始时区 |
-| `<to_tz>` | 需要转换的时区 |
+| `<dt>` | 需要被转换的值,为 `datetime` 或者 `date` 类型，最高有六位秒数的精度(如 23:59:59.999999) |
Review Comment:
例子错误，23:59:59.999999不是一个合法的datetime或date
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md:
##########
@@ -7,7 +7,11 @@
## 描述
-向日期添加指定的时间间隔。
+DATE_ADD 函数用于向指定的日期或时间值添加指定的时间间隔，并返回计算后的结果。
+
+- 支持的输入日期类型包括 DATE、DATETIME、TIMESTAMP，或符合格式的字符串（如 '2023-12-31'、'2023-12-31
23:59:59'）。
Review Comment:
下面参数列表写了“待处理的日期 / 时间值。支持类型：DATE,DATETIME”，这里怎么会还接受字符串呢？
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/convert-tz.md:
##########
@@ -7,8 +7,7 @@
## 描述
-转换 datetime 值，从 from_tz 给定时区转到 to_tz 给定时区，并返回结果值。特殊情况：
-- 如果参数无效该函数返回 NULL。
+转换 datetime 值，从 from_tz 给定时区转到 to_tz 给定时区，并返回结果值,时区设置请观看 time-zone 文档。
Review Comment:
观看 -> 查看。
文档要给个内链，内链用相对路径，不带文件后缀名
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/datediff.md:
##########
@@ -29,25 +29,47 @@ DATEDIFF(<expr1>, <expr2>)
## 举例
```sql
+
+-- 两个日期相差1天（忽略时间部分）
Review Comment:
这里需要一些关键例子：
2000-01-01 12:00:00 和 2000-01-02
2000-01-03 12:00:00 和 2000-01-02 13:00:00
来说明忽略time部分。
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-format.md:
##########
@@ -70,92 +70,98 @@ yyyy-MM-dd HH:mm:ss
## 返回值
-格式化后的日期字符串，特殊情况：
-
-- 当前支持最大 128 字节的字符串，如果返回值长度超过 128，则返回 NULL。
+格式化后的日期字符串。
+特殊情况：
+- 输入日期无效（如 '2023-13-01'）返回 NULL。
Review Comment:
这个函数还有长度限制问题。
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/convert-tz.md:
##########
@@ -20,38 +19,88 @@ CONVERT_TZ(<dt>, <from_tz>, <to_tz>)
| 参数 | 说明 |
| -- | -- |
-| `<dt>` | 需要被转换的 datetime 值 |
-| `<from_tz>` | dt 的原始时区 |
-| `<to_tz>` | 需要转换的时区 |
+| `<dt>` | 需要被转换的值,为 `datetime` 或者 `date` 类型，最高有六位秒数的精度(如 23:59:59.999999) |
+| `<from_tz>` | dt 的原始时区,该参数为 `varchar` 类型 |
+| `<to_tz>` | 需要转换的时区 ，该参数为 `varchar` 类型|
## 返回值
-转换后的 datetime 值
+转换后的 timestamp 值
+对于不带有 scale 的 datetime 输入, 返回结果也不带有 scale, 带有 scale 的输入，返回也没有scale
+特殊情况:
+- 如果参数无效（如无效的 datetime 格式、不存在的时区标识等），该函数返回 NULL。
Review Comment:
无效的datetime格式是什么？
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/convert-tz.md:
##########
@@ -20,38 +19,88 @@ CONVERT_TZ(<dt>, <from_tz>, <to_tz>)
| 参数 | 说明 |
| -- | -- |
-| `<dt>` | 需要被转换的 datetime 值 |
-| `<from_tz>` | dt 的原始时区 |
-| `<to_tz>` | 需要转换的时区 |
+| `<dt>` | 需要被转换的值,为 `datetime` 或者 `date` 类型，最高有六位秒数的精度(如 23:59:59.999999) |
+| `<from_tz>` | dt 的原始时区,该参数为 `varchar` 类型 |
+| `<to_tz>` | 需要转换的时区 ，该参数为 `varchar` 类型|
## 返回值
-转换后的 datetime 值
+转换后的 timestamp 值
+对于不带有 scale 的 datetime 输入, 返回结果也不带有 scale, 带有 scale 的输入，返回也没有scale
Review Comment:
“带有 scale 的输入，返回也没有scale”？
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-floor.md:
##########
@@ -17,96 +17,90 @@
| 参数 | 说明 |
| -- | -- |
-| `datetime` | 参数是合法的日期表达式 |
-| `period` | 参数是指定每个周期有多少个单位组成，开始的时间起点为 0001-01-01T00:00:00 |
-| `type` | 参数可以是：YEAR, MONTH, DAY, HOUR, MINUTE, SECOND |
+| `datetime` | 参数是合法的日期表达式，类型为 `DATE` 或者 `DATETIME` |
+| `period` | 参数是指定每个周期有多少个单位组成,为 `INT` 类型，开始的时间起点为 0001-01-01T00:00:00 |
+| `type` | 参数可以是：YEAR, MONTH, DAY, HOUR, MINUTE, SECOND,WEEK |
## 返回值
-返回的是一个日期或时间值，表示将输入值向下舍入到指定单位的结果。
+返回一个日期按照 period 周期向下取整的结果，类型和 <datetime> 保持一致
+若输入有效，返回与 <datetime> 类型一致的取整结果：
+- 输入 DATE 时，返回 DATE（仅日期部分，时间默认为 00:00:00）；
+- 输入 DATETIME 或带时间的字符串时，返回 DATETIME（包含日期和时间）。
+特殊情况：
+- 任何参数为 NULL 时，返回 NULL；
+- 无效日期、非法 <period>（非正整数）或 <type> 时，返回 NULL；
+- 若取整结果早于日期类型支持的最小值（如 '0001-01-01' 之前），返回 NULL。
## 举例
```sql
-select date_floor("0001-01-01 00:00:16",interval 5 second);
-```
-
-```text
-+---------------------------------------------------------------+
-| second_floor('0001-01-01 00:00:16', 5, '0001-01-01 00:00:00') |
-+---------------------------------------------------------------+
-| 0001-01-01 00:00:15 |
-+---------------------------------------------------------------+
-```
-
-```sql
-select date_floor("0001-01-01 00:00:18",interval 5 second);
-```
-
-```text
-+---------------------------------------------------------------+
-| second_floor('0001-01-01 00:00:18', 5, '0001-01-01 00:00:00') |
-+---------------------------------------------------------------+
-| 0001-01-01 00:00:15 |
-+---------------------------------------------------------------+
-```
-
-```sql
-select date_floor("2023-07-13 22:28:18",interval 5 minute);
-```
-
-```text
-+---------------------------------------------------------------+
-| minute_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
-+---------------------------------------------------------------+
-| 2023-07-13 22:25:00 |
-+---------------------------------------------------------------+
-```
-
-```sql
-select date_floor("2023-07-13 22:28:18",interval 5 hour);
-```
-
-```text
-+-------------------------------------------------------------+
-| hour_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
-+-------------------------------------------------------------+
-| 2023-07-13 18:00:00 |
-+-------------------------------------------------------------+
-```
-
-```sql
-select date_floor("2023-07-13 22:28:18",interval 5 day);
-```
-
-```text
-+------------------------------------------------------------+
-| day_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
-+------------------------------------------------------------+
-| 2023-07-10 00:00:00 |
-+------------------------------------------------------------+
-```
-
-```sql
-select date_floor("2023-07-13 22:28:18",interval 5 month);
-```
-
-```text
-+--------------------------------------------------------------+
-| month_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
-+--------------------------------------------------------------+
-| 2023-07-01 00:00:00 |
-+--------------------------------------------------------------+
-```
-
-```sql
-select date_floor("2023-07-13 22:28:18",interval 5 year);
-```
-
-```text
-+-------------------------------------------------------------+
-| year_floor('2023-07-13 22:28:18', 5, '0001-01-01 00:00:00') |
-+-------------------------------------------------------------+
-| 2021-01-01 00:00:00 |
-+-------------------------------------------------------------+
+-- 按 5 秒向下取整（周期起点为 00、05、10...秒）
+mysql> select date_floor("0001-01-01 00:00:18", INTERVAL 5 SECOND);
++------------------------------------------------------+
+| date_floor("0001-01-01 00:00:18", INTERVAL 5 SECOND) |
++------------------------------------------------------+
+| 0001-01-01 00:00:15 |
++------------------------------------------------------+
+
+-- 输入时间恰好是 5 天周期的起点
+mysql> select date_floor("2023-07-10 00:00:00", INTERVAL 5 DAY);
++---------------------------------------------------+
+| date_floor("2023-07-10 00:00:00", INTERVAL 5 DAY) |
++---------------------------------------------------+
+| 2023-07-10 00:00:00 |
++---------------------------------------------------+
+
+--- date 类型的向下取整
+mysql> select date_floor("2023-07-13", INTERVAL 5 YEAR);
++-------------------------------------------+
+| date_floor("2023-07-13", INTERVAL 5 YEAR) |
++-------------------------------------------+
+| 2021-01-01 00:00:00 |
++-------------------------------------------+
+
+---period 为负数，无效返回 NULL
+mysql> select date_floor("2023-07-13 22:28:18", INTERVAL -5 MINUTE);
++-------------------------------------------------------+
+| date_floor("2023-07-13 22:28:18", INTERVAL -5 MINUTE) |
++-------------------------------------------------------+
+| NULL |
++-------------------------------------------------------+
+
+---datetime 无效，返回 NULL
+mysql> select date_floor("2023-02-30 22:28:18", INTERVAL 5 DAY);
Review Comment:
0是否也无效？给个例子
--
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]
