💬Generate LLM translations (#1845)

Author: github-actions[bot]

docs/cn/sql-reference/20-sql-functions/05-datetime-functions/date-diff.md

@@ -3,44 +3,56 @@ title: DATE_DIFF
 ---
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="引入或更新: v1.2.645"/>
+<FunctionDescription description="Introduced or updated: v1.2.723"/>
 
-根据指定的时间单位计算两个日期或时间戳之间的差异。如果 `<end_date>` 在 `<start_date>` 之后，结果为正；如果 `<end_date>` 在 `<start_date>` 之前，结果为负。
+计算两个日期或时间戳之间基于指定时间单位的差值。如果 `<end_date>` 在 `<start_date>` 之后，结果为正；如果 `<end_date>` 在 `<start_date>` 之前，结果为负。
 
 ## 语法
 
 ```sql
-DATE_DIFF(<unit>, <start_date>, <end_date>)
+DATE_DIFF(
+  YEAR | QUARTER | MONTH | WEEK | DAY | HOUR | MINUTE | SECOND |
+  DOW | DOY | EPOCH | ISODOW | YEARWEEK | MILLENNIUM,
+  <start_date_or_timestamp>,
+  <end_date_or_timestamp>
+)
 ```
 
-| 参数           | 描述                                                                                                 |
-|----------------|-------------------------------------------------------------------------------------------------------------|
-| `<unit>`       | 差异的时间单位：`YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE`, 或 `SECOND`。 |
-| `<start_date>` | 起始日期或时间戳。                                                                             |
-| `<end_date>`   | 结束日期或时间戳。                                                                               |
+| 关键字      | 描述                                                                  |
+|--------------|-----------------------------------------------------------------------|
+| `DOW`        | 星期几。 星期日 (0) 到星期六 (6)。                                      |
+| `DOY`        | 一年中的第几天。 1 到 366。                                           |
+| `EPOCH`      | 自 1970-01-01 00:00:00 以来的秒数。                                  |
+| `ISODOW`     | ISO 星期几。 星期一 (1) 到星期日 (7)。                                 |
+| `YEARWEEK`   | 年和周数的组合，遵循 ISO 8601 标准（例如，202415）。                  |
+| `MILLENNIUM` | 日期的千年（1 代表 1-1000 年，2 代表 1001-2000 年，依此类推）。 |
 
 ## 示例
 
-此示例计算**昨天**和**今天**之间的小时差：
+此示例计算固定时间戳 (`2020-01-01 00:00:00`) 与当前时间戳 (`NOW()`) 之间的差值，涵盖各种单位，如年、ISO 星期几、年-周和千年：
 
 ```sql
-SELECT DATE_DIFF(HOUR, YESTERDAY(), TODAY());
-
-┌───────────────────────────────────────┐
-│ DATE_DIFF(HOUR, yesterday(), today()) │
-├───────────────────────────────────────┤
-│                                    24 │
-└───────────────────────────────────────┘
+SELECT
+  DATE_DIFF(YEAR,        TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_year,
+  DATE_DIFF(QUARTER,     TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_quarter,
+  DATE_DIFF(MONTH,       TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_month,
+  DATE_DIFF(WEEK,        TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_week,
+  DATE_DIFF(DAY,         TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_day,
+  DATE_DIFF(HOUR,        TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_hour,
+  DATE_DIFF(MINUTE,      TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_minute,
+  DATE_DIFF(SECOND,      TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_second,
+  DATE_DIFF(DOW,         TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_dow,
+  DATE_DIFF(DOY,         TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_doy,
+  DATE_DIFF(EPOCH,       TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_epoch,
+  DATE_DIFF(ISODOW,      TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_isodow,
+  DATE_DIFF(YEARWEEK,    TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_yearweek,
+  DATE_DIFF(MILLENNIUM,  TIMESTAMP '2020-01-01 00:00:00', NOW())        AS diff_millennium;
 ```
 
-此示例计算当前日期与2000年1月1日之间的年份差：
-
 ```sql
-SELECT NOW(), DATE_DIFF(YEAR, NOW(), TO_DATE('2000-01-01'));
-
-┌────────────────────────────────────────────────────────────────────────────┐
-│            now()           │ DATE_DIFF(YEAR, now(), to_date('2000-01-01')) │
-├────────────────────────────┼───────────────────────────────────────────────┤
-│ 2024-10-15 03:38:23.726599 │                                           -24 │
-└────────────────────────────────────────────────────────────────────────────┘
+┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│ diff_year │ diff_quarter │ diff_month │ diff_week │ diff_day │ diff_hour │ diff_minute │ diff_second │ diff_dow │ diff_doy │ diff_epoch │ diff_isodow │ diff_yearweek │ diff_millennium │
+├───────────┼──────────────┼────────────┼───────────┼──────────┼───────────┼─────────────┼─────────────┼──────────┼──────────┼────────────┼─────────────┼───────────────┼─────────────────┤
+│         5 │           21 │         63 │       276 │     1932 │     46386 │     2783184 │   166991069 │     1932 │     1932 │  166991069 │        1932 │           515 │               0 │
+└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
 ```

docs/cn/sql-reference/20-sql-functions/05-datetime-functions/date-part.md

@@ -4,66 +4,61 @@ title: DATE_PART
 
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="引入或更新：v1.2.153"/>
+<FunctionDescription description="Introduced or updated: v1.2.723"/>
 
-提取日期、时间或时间戳的指定部分。
+检索日期或时间戳的指定部分。
 
 另请参阅：[EXTRACT](extract.md)
 
 ## 语法
 
 ```sql
-DATE_PART( YEAR | QUARTER | MONTH | WEEK | DAY | HOUR | MINUTE | SECOND | DOW | DOY, <date_or_time_expr> )
+DATE_PART(
+  YEAR | QUARTER | MONTH | WEEK | DAY | HOUR | MINUTE | SECOND |
+  DOW | DOY | EPOCH | ISODOW | YEARWEEK | MILLENNIUM,
+  <date_or_timestamp_expr>
+)
 ```
 
-- DOW：星期几。
-- DOY：一年中的第几天。
+| 关键字      | 描述                                                                  |
+|--------------|-----------------------------------------------------------------------|
+| `DOW`        | 星期几。 星期日 (0) 到星期六 (6)。                                       |
+| `DOY`        | 一年中的第几天。 1 到 366。                                            |
+| `EPOCH`      | 自 1970-01-01 00:00:00 以来的秒数。                                  |
+| `ISODOW`     | ISO 星期几。 星期一 (1) 到星期日 (7)。                                 |
+| `YEARWEEK`   | 遵循 ISO 8601 的年份和周数组合（例如，202415）。                       |
+| `MILLENNIUM` | 日期的千年（1 表示 1-1000 年，2 表示 1001-2000 年，依此类推）。 |
 
 ## 返回类型
 
 整数。
 
 ## 示例
 
-```sql
-SELECT NOW();
-
-┌────────────────────────────┐
-│            now()           │
-├────────────────────────────┤
-│ 2024-05-22 02:55:52.954761 │
-└────────────────────────────┘
-
-SELECT DATE_PART(DAY, NOW());
-
-┌───────────────────────┐
-│ date_part(day, now()) │
-├───────────────────────┤
-│                    22 │
-└───────────────────────┘
-
-SELECT DATE_PART(DOW, NOW());
-
-┌───────────────────────┐
-│ date_part(dow, now()) │
-├───────────────────────┤
-│                     3 │
-└───────────────────────┘
+此示例演示如何使用 DATE_PART 从当前时间戳中提取各种组成部分，例如年、月、ISO 星期几、年-周组合和千年：
 
-SELECT DATE_PART(DOY, NOW());
-
-┌───────────────────────┐
-│ date_part(doy, now()) │
-├───────────────────────┤
-│                   143 │
-└───────────────────────┘
-
-SELECT DATE_PART(MONTH, TO_DATE('2024-05-21'));
+```sql
+SELECT
+  DATE_PART(YEAR, NOW())        AS year_part,
+  DATE_PART(QUARTER, NOW())     AS quarter_part,
+  DATE_PART(MONTH, NOW())       AS month_part,
+  DATE_PART(WEEK, NOW())        AS week_part,
+  DATE_PART(DAY, NOW())         AS day_part,
+  DATE_PART(HOUR, NOW())        AS hour_part,
+  DATE_PART(MINUTE, NOW())      AS minute_part,
+  DATE_PART(SECOND, NOW())      AS second_part,
+  DATE_PART(DOW, NOW())         AS dow_part,
+  DATE_PART(DOY, NOW())         AS doy_part,
+  DATE_PART(EPOCH, NOW())       AS epoch_part,
+  DATE_PART(ISODOW, NOW())      AS isodow_part,
+  DATE_PART(YEARWEEK, NOW())    AS yearweek_part,
+  DATE_PART(MILLENNIUM, NOW())  AS millennium_part;
+```
 
-┌─────────────────────────────────────────┐
-│ date_part(month, to_date('2024-05-21')) │
-│                  UInt8                  │
-├─────────────────────────────────────────┤
-│                                       5 │
-└─────────────────────────────────────────┘
+```sql
+┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│ year_part │ quarter_part │ month_part │ week_part │ day_part │ hour_part │ minute_part │ second_part │ dow_part │ doy_part │     epoch_part    │ isodow_part │ yearweek_part │ millennium_part │
+├───────────┼──────────────┼────────────┼───────────┼──────────┼───────────┼─────────────┼─────────────┼──────────┼──────────┼───────────────────┼─────────────┼───────────────┼─────────────────┤
+│      2025 │            2 │          4 │        16 │       16 │        18 │          10 │          10 │        3 │      106 │ 1744827010.257671 │           3 │        202516 │               3 │
+└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
 ```