zclllyybb commented on code in PR #2820: URL: https://github.com/apache/doris-website/pull/2820#discussion_r2374747800
########## i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year-of-week.md: ########## @@ -5,47 +5,102 @@ } --- -## year_of_week - -year_of_week - ## 描述 -求 `ISO week date` 标准的周年，与年的区别可以参见 [ISO周日历](https://zh.wikipedia.org/wiki/ISO%E9%80%B1%E6%97%A5%E6%9B%86) 。 +YEAR_OF_WEEK 函数用于返回指定日期在 ISO 8601 周日历标准下的周年（year of week）。与普通年份不同，ISO 周年以周为单位计算，一年的第一周是包含 1 月 4 日的那一周，且该周必须包含至少 4 天属于当年。 +与 [year 函数](./year) 不同，year 函数只是返回输入日期的年份 + +更多详细信息请参见 [ISO周日历](https://zh.wikipedia.org/wiki/ISO%E9%80%B1%E6%97%A5%E6%9B%86)。 ## 别名 -- yow +- `YOW` ## 语法 - ```sql -SMALLINT year_of_week(DATE value) +YEAR_OF_WEEK(`<date_or_time_expr>`) +YOW(`<date_or_time_expr>`) ``` - ## 参数 -| 参数 | 说明 | -| -- | -- | -| `<value>` | 需要求周年的日期 | +| 参数 | 描述 | +|------|------| +| `<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) | ## 返回值 -返回 `ISO week date` 标准的周年。 +返回 SMALLINT 类型，表示根据 ISO 8601 周日历标准计算的周年。 + +- 返回值范围通常为 1-9999 Review Comment: remove通常 -- 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]
