zclllyybb commented on code in PR #2811:
URL: https://github.com/apache/doris-website/pull/2811#discussion_r2346956047
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-diff.md:
##########
@@ -7,42 +7,81 @@
## 描述
-计算两个日期时间值之间的分钟差值。结果为 `<end_date>` 减去 `<start_date>` 的分钟数。
+UTES_DIFF 函数用于计算两个日期时间值之间的分钟差值，结果为结束时间减去开始时间的分钟数。该函数支持处理
DATE、DATETIME（含微秒精度）类型。
Review Comment:
typo
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-floor.md:
##########
@@ -7,50 +7,103 @@
## 描述
-将日期时间值向下取整到最近的指定月份周期。如果指定了起始时间（origin），则以该时间为基准计算周期。
+MINUTE_FLOOR
函数用于将输入的日期时间值向下取整到最近的指定分钟周期。若指定起始时间（origin），则以该时间为基准划分周期并取整；若未指定，默认以 0001-01-01
00:00:00 为基准。该函数支持处理 DATETIME 类型。
+
+日期时间的计算公式
+MINUTE_FLOOR(`<date_or_time_expr>`, `<period>`, `<origin>`) = max{`<origin>` +
k × `<period>` × minute| k ∈ ℤ ∧ `<origin>` + k × `<period>` × minute ≤
`<date_or_time_expr>`}
+K 代表的是基准时间到目标时间的周期数
## 语法
```sql
-MONTH_FLOOR(<datetime>)
-MONTH_FLOOR(<datetime>, <origin>)
-MONTH_FLOOR(<datetime>, <period>)
-MONTH_FLOOR(<datetime>, <period>, <origin>)
+MINUTE_FLOOR(`<date_or_time_expr>`)
+MINUTE_FLOOR(`<date_or_time_expr>`, `<origin>`)
+MINUTE_FLOOR(`<date_or_time_expr>`, `<period>`)
+MINUTE_FLOOR(`<date_or_time_expr>, `<period>`, `<origin>`)
```
## 参数
| 参数 | 说明 |
| ---- | ---- |
-| `<datetime>` | 需要向下取整的日期时间值，类型为 DATETIME 或 DATETIMEV2 |
-| `<period>` | 月份周期值，类型为 INT，表示每个周期包含的月数 |
-| `<origin>` | 周期的起始时间点，类型为 DATETIME 或 DATETIMEV2，默认值为 0001-01-01 00:00:00 |
+| ``<date_or_time_expr>`` | 需要向下取整的日期时间值，类型为 DATETIME 或 DATE ，具体 datetime/date
格式请查看 [datetime
的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)
和 [date
的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)|
+| ``<period>`` | 月份周期值，类型为 INT，表示每个周期包含的月数 |
+| ``<origin>`` | 周期的起始时间点，类型为 DATETIME/DATE ，默认值为 0001-01-01 00:00:00 |
Review Comment:
``是不对的
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/minutes-sub.md:
##########
@@ -7,41 +7,81 @@
## 描述
-从日期时间值中减去指定的分钟数，返回一个新的日期时间值。
+MINUTES_SUB 函数用于从输入的日期时间值中减去指定的分钟数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME类型.
+
+该函数与 mysql 的 [date-add
函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add)
使用 MINUTE 为单位的行为一致。
Review Comment:
sub的文档都要用date_sub的对应链接和文字
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-between.md:
##########
@@ -7,53 +7,97 @@
## 描述
-`MONTHS_BETWEEN` 函数计算两个日期之间的月份数（浮点数）。它接收两个日期参数和一个可选的布尔参数。
+与 [month_diff 函数](./month-diff) 不同的是，month-between
函数不会忽略日单位，返回的是浮点数，代表真实差距多少个月，而不是日期上显示的月单位所差的月数
+MONTHS_BETWEEN 函数用于计算两个日期时间值之间的月份差值，返回结果为浮点数。该函数支持处理 DATE、DATETIME
类型，并可通过可选参数控制结果是否四舍五入。
-:::tip
-该函数自 3.0.6 版本开始支持.
-:::
-
-**注意：**
-当 `<enddate>` 和 `<startdate>`
都是各自月份的最后一天时，函数会进行特殊处理。它会返回完整的月份差值，而不考虑基于天数的分数部分。这确保了在比较一个月末与另一个月末时的一致性。
-
-例如：
-- `months_between('2024-01-31', '2024-02-29')` 将返回
`-1.0`，因为两个日期都是各自月份的最后一天（1月31日和2月29日），所以结果被视为完整的月份差值，不进行分数调整。
-- `months_between('2024-01-29', '2024-02-29')` 也将返回 `-1.0`，因为月份中的日期相同。
-- `months_between('2024-01-30', '2024-02-29')` 将返回
`-0.96774194`，因为月份中的日期不同且不是月末。
+该函数与 orcle 的 [month-between
函数](https://docs.oracle.com/cd/E11882_01/olap.112/e23381/row_functions042.htm#OLAXS434)
行为一致
## 语法
```sql
-MONTHS_BETWEEN(<enddate>, <startdate> [, <round_type>])
+MONTHS_BETWEEN(`<date_or_time_expr1>`, `<date_or_time_expr2>` [,
`<round_type>`])
```
## 参数
| 参数 | 说明 |
|-------------------|------------------------------------------------------------|
-| `<enddate>` | 结束日期，表示差值计算中的较晚日期。支持 `DATE`（如 `YYYY-MM-DD`）或 `DATETIME`（如
`YYYY-MM-DD HH:MM:SS`）类型。 |
-| `<startdate>` | 开始日期，表示差值计算中的较早日期。支持 `DATE`（如 `YYYY-MM-DD`）或 `DATETIME`（如
`YYYY-MM-DD HH:MM:SS`）类型。 |
-| `<round_type>` | 是否将结果四舍五入到第八位小数。支持 `true` 或 `false`。默认为 `true`。 |
+| ``<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 类型和符合日期时间格式的字符串. |
+| ``<round_type>`` | 是否将结果四舍五入到第八位小数。支持 `true` 或 `false`。默认为 `true`。 |
Review Comment:
pr里很多地方反引号有问题
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-ceil.md:
##########
@@ -7,49 +7,105 @@
## 描述
-将日期时间值向上取整到最近的指定月份周期。如果指定了起始时间（origin），则以该时间为基准计算周期。
+MONTH_CEIL
函数用于将输入的日期时间值向上取整到最近的指定月份周期。若指定起始时间（origin），则以该时间为基准划分周期并取整；若未指定，默认以 0001-01-01
00:00:00 为基准。该函数支持处理 DATETIME、DATE 类型。
+
+日期计算公式
+MONTH_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`) = min{`<origin>` + k
× `<period>` × month | k ∈ ℤ ∧ `<origin>` + k × `<period>` × month ≥
`<date_or_time_expr>`}
+K 代表基准时间到达目标时间所需的周期数
## 语法
```sql
-MONTH_CEIL(<datetime>)
-MONTH_CEIL(<datetime>, <origin>)
-MONTH_CEIL(<datetime>, <period>)
-MONTH_CEIL(<datetime>, <period>, <origin>)
+MONTH_CEIL(`<date_or_time_expr>`)
+MONTH_CEIL(`<date_or_time_expr>`, `<origin>`)
+MONTH_CEIL(`<date_or_time_expr>`, `<period>`)
+MONTH_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)
```
## 参数
| 参数 | 说明 |
| ---- | ---- |
-| `<datetime>` | 需要向上取整的日期时间值，类型为 DATETIME 或 DATETIMEV2 |
-| `<period>` | 月份周期值，类型为 INT，表示每个周期包含的月数 |
-| `<origin>` | 周期的起始时间点，类型为 DATETIME 或 DATETIMEV2，默认值为 0001-01-01 00:00:00 |
+| ``<date_or_time_expr>`` | 需要向上取整的日期时间值，参数是合法的日期表达式，支持输入 date/datetime 类型,具体
datetime 和 date 格式请查看 [datetime
的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)
和 [date
的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)
|
+| ``<period>`` | 月份周期值，类型为 INT，表示每个周期包含的月数 |
+| ``<origin>`` | 周期的起始时间点，支持输入 date/datetime 类型，默认值为 0001-01-01 00:00:00 |
## 返回值
-返回类型为 DATETIME，表示向上取整后的日期时间值。结果的时间部分将被设置为 00:00:00。
+返回类型为 DATETIME，返回以输入日期时间为基准，向上取整到最近的指定月份周期后的时间值。结果的时间部分将被设置为 00:00:00,日部分会截断为
01。
+
+- 若 `<period>` 为非正整数（≤0），返回错误。
+- 若任一参数为 NULL，返回 NULL。
+- 不指定 period 时，默认以 1 个月为周期。
+- `<origin>` 未指定，默认以 0001-01-01 00:00:00 为基准。
+- 输入为 DATE 类型（默认时间 00:00:00）。
+- 计算结果超过日期最大范围 9999-12-31 23:59:59，结果返回错误
## 举例
```sql
-SELECT MONTH_CEIL("2023-07-13 22:28:18", 5);
-```
+--- 以默认周期1个月，默认起始时间 0001-01-01 00:00:00
+SELECT MONTH_CEIL('2023-07-13 22:28:18') AS result;
++---------------------+
+| result |
++---------------------+
+| 2023-08-01 00:00:00 |
++---------------------+
-```text
-+-------------------------------------------------------------+
-| month_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
-+-------------------------------------------------------------+
-| 2023-10-01 00:00:00 |
-+-------------------------------------------------------------+
-```
+--- 以5个月为一周期，以默认起始点的向上取整结果
+SELECT MONTH_CEIL('2023-07-13 22:28:18', 5) AS result;
++---------------------+
+| result |
++---------------------+
+| 2023-12-01 00:00:00 |
++---------------------+
+
+---输入日期时间恰好在周期起点，则返回输入日期时间
+SELECT MONTH_CEIL('2023-12-01 00:00:00', 5) AS result;
++----------------------------+
+| result |
++----------------------------+
+| 2023-12-01 00:00:00 |
++----------------------------+
-注意：
-- 不指定 period 时，默认以 1 个月为周期
-- period 必须为正整数
-- 结果总是向未来时间取整
-- 返回值的时间部分总是 00:00:00
+--- 指定起始时间（origin）
+SELECT MONTH_CEIL('2023-07-13 22:28:18', 5, '2023-01-01 00:00:00') AS result;
Review Comment:
ceil 和 floor，输入值在origin之前会怎么样？
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/month-ceil.md:
##########
@@ -7,49 +7,105 @@
## 描述
-将日期时间值向上取整到最近的指定月份周期。如果指定了起始时间（origin），则以该时间为基准计算周期。
+MONTH_CEIL
函数用于将输入的日期时间值向上取整到最近的指定月份周期。若指定起始时间（origin），则以该时间为基准划分周期并取整；若未指定，默认以 0001-01-01
00:00:00 为基准。该函数支持处理 DATETIME、DATE 类型。
+
+日期计算公式
+MONTH_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`) = min{`<origin>` + k
× `<period>` × month | k ∈ ℤ ∧ `<origin>` + k × `<period>` × month ≥
`<date_or_time_expr>`}
+K 代表基准时间到达目标时间所需的周期数
## 语法
```sql
-MONTH_CEIL(<datetime>)
-MONTH_CEIL(<datetime>, <origin>)
-MONTH_CEIL(<datetime>, <period>)
-MONTH_CEIL(<datetime>, <period>, <origin>)
+MONTH_CEIL(`<date_or_time_expr>`)
+MONTH_CEIL(`<date_or_time_expr>`, `<origin>`)
+MONTH_CEIL(`<date_or_time_expr>`, `<period>`)
+MONTH_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)
```
## 参数
| 参数 | 说明 |
| ---- | ---- |
-| `<datetime>` | 需要向上取整的日期时间值，类型为 DATETIME 或 DATETIMEV2 |
-| `<period>` | 月份周期值，类型为 INT，表示每个周期包含的月数 |
-| `<origin>` | 周期的起始时间点，类型为 DATETIME 或 DATETIMEV2，默认值为 0001-01-01 00:00:00 |
+| ``<date_or_time_expr>`` | 需要向上取整的日期时间值，参数是合法的日期表达式，支持输入 date/datetime 类型,具体
datetime 和 date 格式请查看 [datetime
的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion)
和 [date
的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion)
|
+| ``<period>`` | 月份周期值，类型为 INT，表示每个周期包含的月数 |
+| ``<origin>`` | 周期的起始时间点，支持输入 date/datetime 类型，默认值为 0001-01-01 00:00:00 |
## 返回值
-返回类型为 DATETIME，表示向上取整后的日期时间值。结果的时间部分将被设置为 00:00:00。
+返回类型为 DATETIME，返回以输入日期时间为基准，向上取整到最近的指定月份周期后的时间值。结果的时间部分将被设置为 00:00:00,日部分会截断为
01。
+
+- 若 `<period>` 为非正整数（≤0），返回错误。
Review Comment:
正浮点数也是非正整数，应该不会出错吧？
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-diff.md:
##########
@@ -6,37 +6,89 @@
---
## 描述
-`MONTHS_DIFF` 函数用于计算两个日期之间相差的月份数。该函数接受两个日期参数，返回第一个日期减去第二个日期后的相差月份数。
+
+MONTHS_DIFF 函数用于计算两个日期时间值之间的整数月份差值，返回结果为 `<enddate>` 减去 `<startdate>`
后的月份数。该函数支持处理 DATE、DATETIME 类型，仅基于日期部分（年、月、日）计算，忽略时间部分（时、分、秒）。
## 语法
```sql
-MONTHS_DIFF(<enddate>, <startdate>)
+MONTHS_DIFF(`<date_or_time_expr1>`, `<date_or_time_expr2>`)
```
## 参数
| 参数 | 说明 |
|---------------|---------------------------------------------------------|
-| `<enddate>` | 结束日期，表示计算差值时的较晚日期。支持日期类型（如 `DATE`）或日期时间类型（如 `DATETIME`） |
-| `<startdate>` | 开始日期，表示计算差值时的较早日期。支持日期类型（如 `DATE`）或日期时间类型（如 `DATETIME`） |
+| ``<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 类型 |
## 返回值
-返回 `<enddate>` 减去 `<startdate>` 所得月份数
-- 当`<enddate>`与`<startdate>`任意为 NULL，或者两者都为 NULL 时，返回 NULL
+返回 `<date_or_time_expr1>` 减去 `<date_or_time_expr2>` 所得月份数，类型为 BIGINT.
+
+基础差值 =（结束年份 - 开始年份）× 12 +（结束月份 - 开始月份）；
Review Comment:
xxx-diff要保持统一的说明风格，要么就都用这种方式，要么就都用别的那种方式
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/now.md:
##########
@@ -6,34 +6,42 @@
---
## 描述
-函数用于获取当前系统时间，返回值为日期时间类型（`DATETIME`）。可以选择性地指定精度以调整返回值的小数秒部分的位数。
+`NOW` 函数用于获取当前系统的日期时间，返回值为 `DATETIME` 类型。支持通过可选参数指定小数秒的精度，以调整返回结果中微秒部分的位数。
+
+该函数与 mysql 的 [now
函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_now)
行为一致。
## 语法
```sql
-NOW([<precision>])
+NOW([`<precision>`])
```
## 参数
| 参数 | 说明
|
|---------------|-------------------------------------------------------------------------------------------------------------------------------------|
-| `<precision>` | 可选参数，表示返回值的小数秒部分的精度，取值范围为 0 到 6。默认为 0，即不返回小数秒部分。 <br/>受限于
JDK 实现，如果用户使用 JDK8 构建 FE，则精度最多支持到毫秒（小数点后三位），更大的精度位将全部填充 0。如果用户有更高精度需求，请使用
JDK11。 |
+| ``<precision>`` | 可选参数，表示返回值的小数秒部分的精度，取值范围为 0 到 6。默认为 0，即不返回小数秒部分。
`<br/>`受限于 JDK 实现，如果用户使用 JDK8 构建 FE，则精度最多支持到毫秒（小数点后三位），更大的精度位将全部填充
0。如果用户有更高精度需求，请使用 JDK11。 |
Review Comment:
same，jdk问题
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/months-add.md:
##########
@@ -6,38 +6,89 @@
---
## 描述
-MONTHS_ADD 函数用于对指定日期添加或减去指定的月份数，并返回计算后的新日期
+
+MONTHS_ADD 函数用于向输入的日期时间值中添加指定的月份数，并返回计算后的新日期时间值。该函数支持处理 DATE、DATETIME
类型，若输入负数则等效于减去对应月份数。
+
+该函数与 mysql 的 [date-add
函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_date_add)
使用 MONTH 为单位的行为一致。
## 语法
-```sql
-MONTHS_ADD(<datetime/date>, <nums>)
-```
+````sql
Review Comment:
反引号数量
--
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]
