zclllyybb commented on code in PR #3130: URL: https://github.com/apache/doris-website/pull/3130#discussion_r2715395465
########## i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/timestamp.md: ########## @@ -9,29 +9,34 @@ ## 描述 TIMESTAMP 将 符合 datetime 格式的字符串转换为 DATETIME 类型 +如果存在第二个时间类型的参数，则计算两参数相加的结果，然后以DATETIME类型的格式返回。 具体 datetime 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion). -该函数与 mysql 中的 [timestamp 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_timestamp) 有些差异，doris 暂不支持带有第二个 time 参数进行日期时间增减。 +该函数与 mysql 中的 [timestamp 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_timestamp) 行为相同。 ## 语法 ```sql -TIMESTAMP(string) +TIMESTAMP(<date_or_datetime_string>[, <time_string>]) ``` ## 参数 | 参数 | 说明 | | ---- | ---- | -| `string` | 日期时间字符串类型 | +| `date_or_datetime_string` | 日期时间字符串类型 | +| `time_string` | 时间字符串类型 | ## 返回值 返回类型为 DATETIME。 -- 若输入为 date 字符串,则时间被设置为 00:00:00 -- 输入 NULL，返回 NULL +当输入参数数量为 1 时，返回将第一个参数转换为 DATETIME 类型的结果。 +当输入参数数量为 2 时，返回两参数相加的结果 + +- 若第一个参数输入为 date 字符串,则时间被设置为 00:00:00 +- 任一参数为 NULL或参数类型不匹配时，返回 NULL ## 举例 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]
