zclllyybb commented on code in PR #2811: URL: https://github.com/apache/doris-website/pull/2811#discussion_r2378157607
########## 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>` 的分钟数。 +MINUTES_DIFF 函数用于计算两个日期时间值之间的分钟差值，结果为结束时间减去开始时间的分钟数。该函数支持处理 DATE、DATETIME（含微秒精度）类型。 ## 语法 ```sql -MINUTES_DIFF(<end_date>, <start_date>) +MINUTES_DIFF(`<date_or_time_expr1>`, `<date_or_time_expr2>`) ``` ## 参数 | 参数 | 说明 | | ---- | ---- | -| `<end_date>` | 结束时间，类型可以是 DATE、DATETIME 或 DATETIMEV2 | -| `<start_date>` | 开始时间，类型可以是 DATE、DATETIME 或 DATETIMEV2 | +| ``<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_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) | ## 返回值 -返回类型为 INT，表示两个时间之间的分钟差值。 -- 如果 `<end_date>` 大于 `<start_date>`，返回正数 -- 如果 `<end_date>` 小于 `<start_date>`，返回负数 +返回 INT 类型的整数，表示 `<date_or_time_expr1>` 与 `<date_or_time_expr2>` 之间的分钟差值（1 小时 = 60 分钟）。 + +- 若 `<date_or_time_expr1>`晚于 `<date_or_time_expr2>`，返回正数。 +- 若 `<date_or_time_expr1>` 早于 `<date_or_time_expr2>`，返回负数。 +- 计算时会计算真实差距，不会忽略秒，微秒。 +- 若输入为 DATE 类型（仅包含年月日），默认其时间部分为 00:00:00。 +- 若输入的日期时间包含 scale ,秒或秒部分不为零，计算时不会忽略。 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]
