zclllyybb commented on code in PR #2820: URL: https://github.com/apache/doris-website/pull/2820#discussion_r2346960771
########## i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/yearweek.md: ########## @@ -5,15 +5,14 @@ } --- -## yearweek ## 描述 -## 语法 -`INT YEARWEEK(DATE date[, INT mode])` +YEARWEEK 函数用于返回指定日期对应的 “年份 + 周数” 组合（格式为 YYYYWW，如 202301 表示 2023 年第 1 周）。该函数通过可选参数 mode 灵活定义一周的起始日和 “第一周” 的判断标准，默认使用 mode=0。 + +若日期所在周属于上一年，返回上一年的年份和对应周数； Review Comment: 这里上一年、下一年都很模糊，直接说返回所在年的所属周数就行了 ########## i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year.md: ########## @@ -5,28 +5,62 @@ } --- -## year ## 描述 +YEAR 函数用于提取指定日期或时间值中的年份部分，返回整数形式的年份。支持处理 DATE、DATETIME 类型 + +该函数与 mysql 中的 [year 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_year) 行为一致 + ## 语法 +```sql +YEAR(<date_or_time_expr>) +``` -`INT YEAR(DATETIME date)` +## 参数 +| 参数 | 说明 | +|---------------------|----------------------------------------------------------| +| `<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) | -返回 date 类型的 year 部分，范围从 1000-9999 +## 返回值 -参数为 Date 或者 Datetime 类型 +返回 date 类型的 year 部分，INT 类型，范围从 0-9999 Review Comment: 上面说的是date/datetime类型 ########## i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/yearweek.md: ########## @@ -27,35 +26,71 @@ |6 |星期日 |1-53 |这一年的日期所占的天数大于等于 4 天的第一个星期| |7 |星期一 |1-53 |这一年中的第一个星期一所在的星期 | -参数为 Date 或者 Datetime 类型 +该函数与 mysql 中的 [yearweek 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_yearweek) 行为一致 -## 举例 +## 语法 +```sql +YEARWEEK(DATE <date_or_time_expr>[, INT mode]) ``` -mysql> select yearweek('2021-1-1'); -+----------------------+ -| yearweek('2021-1-1') | -+----------------------+ -| 202052 | -+----------------------+ -``` -``` -mysql> select yearweek('2020-7-1'); -+----------------------+ -| yearweek('2020-7-1') | -+----------------------+ -| 202026 | -+----------------------+ -``` -``` -mysql> select yearweek('2024-12-30',1); -+------------------------------------+ -| yearweek('2024-12-30 00:00:00', 1) | -+------------------------------------+ -| 202501 | -+------------------------------------+ -``` -### keywords +## 返回值 +返回 INT 类型的整数，格式为 YYYYWW（前 4 位为年份，后 2 位为周数），例如 202305 表示 2023 年第 5 周，202052 表示 2020 年第 52 周。 + +- 若日期所在周属于上一年，返回上一年的年份和周数（如 2021 年 1 月 1 日可能返回 202052）。 +- 若日期所在周属于下一年，返回下一年的年份和第 1 周（如 2024 年 12 月 30 日可能返回 202501）。 +- 若输入为NULL，返回 NULL。 + +## 举例 + +```sql +-- 默认mode=0（星期日起始，第一周含第一个星期日） +-- 2021-01-01是星期五，所在周的第一个星期日为2020-12-27，故属于2020年第52周 +SELECT YEARWEEK('2021-01-01') AS yearweek_mode0; ++----------------+ +| yearweek_mode0 | ++----------------+ +| 202052 | ++----------------+ + +-- mode=1（星期一起始，4天规则，与WEEKOFYEAR一致） +SELECT YEARWEEK('2020-07-01', 1) AS yearweek_mode1; ++----------------+ +| yearweek_mode1 | ++----------------+ +| 202027 | ++----------------+ + +-- mode=1，跨年周（2024-12-30是星期一，所在周2025年日期占比≥4天，属于2025年第1周） +SELECT YEARWEEK('2024-12-30', 1) AS cross_year_mode1; ++-------------------+ +| cross_year_mode1 | ++-------------------+ +| 202501 | ++-------------------+ + +-- mode=5（星期一起始，第一周含第一个星期一） +-- 2023-01-02是星期一（当年第一个星期一），所在周为2023年第1周 +SELECT YEARWEEK('2023-01-02', 5) AS yearweek_mode5; ++----------------+ +| yearweek_mode5 | ++----------------+ +| 202301 | ++----------------+ + +-- 输入为DATE类型 +SELECT YEARWEEK('2023-12-25', 1) AS date_type_mode1; ++-------------------+ +| date_type_mode1 | ++-------------------+ +| 202352 | ++-------------------+ + +-- 输入为NULL（返回NULL） Review Comment: 对应sql语句 ########## i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/year.md: ########## @@ -5,28 +5,62 @@ } --- -## year ## 描述 +YEAR 函数用于提取指定日期或时间值中的年份部分，返回整数形式的年份。支持处理 DATE、DATETIME 类型 + +该函数与 mysql 中的 [year 函数](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_year) 行为一致 + ## 语法 +```sql +YEAR(<date_or_time_expr>) +``` -`INT YEAR(DATETIME date)` +## 参数 +| 参数 | 说明 | +|---------------------|----------------------------------------------------------| +| `<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) | -返回 date 类型的 year 部分，范围从 1000-9999 +## 返回值 -参数为 Date 或者 Datetime 类型 +返回 date 类型的 year 部分，INT 类型，范围从 0-9999 + +- 若输入的参数为 NULL，返回 NULL +- 无效日期（返回 NULL） Review Comment: 无效日期本质上都是输入null，不需要额外描述 -- 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]
