Skip to content

Commit 3fc7012

Browse files
github-actions[bot]github-actions[bot]
authored
💬Generate LLM translations (#1847)
1 parent 992f7da commit 3fc7012

File tree

3 files changed

+97
-10
lines changed

3 files changed

+97
-10
lines changed

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

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: DATE_BETWEEN
3+
---
4+
import FunctionDescription from '@site/src/components/FunctionDescription';
5+
6+
<FunctionDescription description="Introduced or updated: v1.2.725"/>
7+
8+
计算两个日期或时间戳之间的时间间隔，以指定的单位返回差值，正值表示第一个时间早于第二个时间，负值表示相反。
9+
10+
另请参阅：[DATE_DIFF](date-diff.md)
11+
12+
## 语法
13+
14+
```sql
15+
DATE_BETWEEN(
16+
YEAR | QUARTER | MONTH | WEEK | DAY | HOUR | MINUTE | SECOND |
17+
DOW | DOY | EPOCH | ISODOW | YEARWEEK | MILLENNIUM,
18+
<start_date_or_timestamp>,
19+
<end_date_or_timestamp>
20+
)
21+
```
22+
23+
| 关键字 | 描述 |
24+
|--------------|-----------------------------------------------------------------------|
25+
| `DOW` | 星期几。 星期日 (0) 到星期六 (6)。 |
26+
| `DOY` | 一年中的第几天。 1 到 366。 |
27+
| `EPOCH` | 自 1970-01-01 00:00:00 以来的秒数。 |
28+
| `ISODOW` | ISO 星期几。 星期一 (1) 到星期日 (7)。 |
29+
| `YEARWEEK` | 遵循 ISO 8601 的年份和周数组合（例如，202415）。 |
30+
| `MILLENNIUM` | 日期的千年（1 表示 1-1000 年，2 表示 1001-2000 年，依此类推）。 |
31+
32+
## DATE_DIFF vs. DATE_BETWEEN
33+
34+
`DATE_DIFF` 函数计算两个日期之间跨越的用户指定单位（例如，日、月或年）的边界数，而 `DATE_BETWEEN` 计算严格位于它们之间的完整单位数。 例如：
35+
36+
```sql
37+
SELECT
38+
DATE_DIFF(month, '2025-07-31', '2025-10-01'), -- returns 3
39+
DATE_BETWEEN(month, '2025-07-31', '2025-10-01'); -- returns 2
40+
```
41+
42+
在此示例中，`DATE_DIFF` 返回 `3`，因为该范围跨越了三个月边界（7 月 → 8 月 → 9 月 → 10 月），而 `DATE_BETWEEN` 返回 `2`，因为日期之间有两个完整的月份：8 月和 9 月。
43+
44+
## 示例
45+
46+
此示例计算固定时间戳 (`2020-01-01 00:00:00`) 和当前时间戳 (`NOW()`) 之间的差异，跨越各种单位，例如年、ISO 工作日、年-周和千年：
47+
48+
```sql
49+
SELECT
50+
DATE_BETWEEN(YEAR, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_year,
51+
DATE_BETWEEN(QUARTER, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_quarter,
52+
DATE_BETWEEN(MONTH, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_month,
53+
DATE_BETWEEN(WEEK, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_week,
54+
DATE_BETWEEN(DAY, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_day,
55+
DATE_BETWEEN(HOUR, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_hour,
56+
DATE_BETWEEN(MINUTE, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_minute,
57+
DATE_BETWEEN(SECOND, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_second,
58+
DATE_BETWEEN(DOW, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_dow,
59+
DATE_BETWEEN(DOY, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_doy,
60+
DATE_BETWEEN(EPOCH, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_epoch,
61+
DATE_BETWEEN(ISODOW, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_isodow,
62+
DATE_BETWEEN(YEARWEEK, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_yearweek,
63+
DATE_BETWEEN(MILLENNIUM, TIMESTAMP '2020-01-01 00:00:00', NOW()) AS diff_millennium;
64+
```
65+
66+
```sql
67+
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
68+
│ 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 │
69+
├───────────┼──────────────┼────────────┼───────────┼──────────┼───────────┼─────────────┼─────────────┼──────────┼──────────┼────────────┼─────────────┼───────────────┼─────────────────┤
70+
│ 5 │ 21 │ 63 │ 276 │ 1933 │ 46414 │ 2784887 │ 167093234 │ 1933 │ 1933 │ 167093234 │ 1933 │ 276 │ 0 │
71+
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
72+
```

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

Lines changed: 22 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,9 @@ import FunctionDescription from '@site/src/components/FunctionDescription';
55

66
<FunctionDescription description="Introduced or updated: v1.2.723"/>
77

8-
计算两个日期或时间戳之间基于指定时间单位的差值。如果 `<end_date>` 在 `<start_date>` 之后，结果为正；如果 `<end_date>` 在 `<start_date>` 之前，结果为负。
8+
计算基于指定时间单位的两个日期或时间戳之间的差值。如果 `<end_date>` 在 `<start_date>` 之后，则结果为正；如果 `<end_date>` 在 `<start_date>` 之前，则结果为负。
9+
10+
另请参阅：[DATE_BETWEEN](date-between.md)
911

1012
## 语法
1113

@@ -20,16 +22,28 @@ DATE_DIFF(
2022

2123
| 关键字 | 描述 |
2224
|--------------|-----------------------------------------------------------------------|
23-
| `DOW` | 星期几。 星期日 (0) 到星期六 (6)。 |
24-
| `DOY` | 一年中的第几天。 1 到 366。 |
25-
| `EPOCH` | 自 1970-01-01 00:00:00 以来的秒数。 |
26-
| `ISODOW` | ISO 星期几。 星期一 (1) 到星期日 (7)。 |
27-
| `YEARWEEK` | 年和周数的组合，遵循 ISO 8601 标准（例如，202415）。 |
28-
| `MILLENNIUM` | 日期的千年（1 代表 1-1000 年，2 代表 1001-2000 年，依此类推）。 |
25+
| `DOW` | Day of the Week. 星期日 (0) 到星期六 (6). |
26+
| `DOY` | Day of the Year. 1 到 366. |
27+
| `EPOCH` | 自 1970-01-01 00:00:00 以来的秒数。 |
28+
| `ISODOW` | ISO Day of the Week. 星期一 (1) 到星期日 (7). |
29+
| `YEARWEEK` | 遵循 ISO 8601 的年份和周数组合 (例如，202415)。 |
30+
| `MILLENNIUM` | 日期的千年 (1 表示 1–1000 年，2 表示 1001–2000 年，依此类推)。 |
31+
32+
## DATE_DIFF vs. DATE_BETWEEN
33+
34+
`DATE_DIFF` 函数计算两个日期之间跨越的用户指定单位（如天、月或年）的边界数，而 `DATE_BETWEEN` 计算严格介于它们之间的完整单位数。例如：
35+
36+
```sql
37+
SELECT
38+
DATE_DIFF(month, '2025-07-31', '2025-10-01'), -- returns 3
39+
DATE_BETWEEN(month, '2025-07-31', '2025-10-01'); -- returns 2
40+
```
41+
42+
在此示例中，`DATE_DIFF` 返回 `3`，因为该范围跨越了三个月边界（7 月 → 8 月 → 9 月 → 10 月），而 `DATE_BETWEEN` 返回 `2`，因为日期之间有两个完整的月份：8 月和 9 月。
2943

3044
## 示例
3145

32-
此示例计算固定时间戳 (`2020-01-01 00:00:00`) 与当前时间戳 (`NOW()`) 之间的差值，涵盖各种单位，如年、ISO 星期几、年-周和千年：
46+
此示例计算固定时间戳 (`2020-01-01 00:00:00`) 与当前时间戳 (`NOW()`) 之间在各种单位（如年、ISO 工作日、年-周和千年）上的差异：
3347

3448
```sql
3549
SELECT

‎docs/cn/sql-reference/20-sql-functions/05-datetime-functions/index.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,11 +49,13 @@ title: 日期 & 时间函数
4949
- [MILLENNIUM](millennium.md)
5050
- [YEARWEEK](yearweek.md)
5151

52-
## 日期计算函数
52+
## 日期算术函数
5353

5454
- [ADD INTERVAL](addinterval.md)
5555
- [DATE_ADD](date-add)
5656
- [DATE_SUB](date-sub)
57+
- [DATE_DIFF](date-diff)
58+
- [DATE_BETWEEN](date-between.md)
5759
- [SUBTRACT INTERVAL](subtractinterval.md)
5860
- [MONTHS_BETWEEN](months-between.md)
5961
- [LAST_DAY](last-day.md)
@@ -64,7 +66,6 @@ title: 日期 & 时间函数
6466
## 日期信息函数
6567

6668
- [DATE_PART](date-part.md)
67-
- [DATE_DIFF](date-diff)
6869
- [DATE_FORMAT](date-format)
6970
- [DATE_TRUNC](date-trunc)
7071
- [NOW](now.md)

0 commit comments

Comments
 (0)