Skip to content

Commit da07dc0

Browse files
💬Generate LLM translations (#1108)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Quan <[email protected]>
1 parent 84ac91b commit da07dc0

File tree

2 files changed

+73
-1
lines changed

2 files changed

+73
-1
lines changed

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,12 +47,13 @@ title: 日期与时间函数
4747
- [TO_YYYYMMDDHH](to-yyyymmddhh)
4848
- [TO_YYYYMMDDHHMMSS](to-yyyymmddhhmmss)
4949

50-
## 日期运算函数
50+
## 日期算术函数
5151

5252
- [ADD INTERVAL](addinterval.md)
5353
- [DATE_ADD](date-add)
5454
- [DATE_SUB](date-sub)
5555
- [SUBTRACT INTERVAL](subtractinterval.md)
56+
- [MONTHS_BETWEEN](months-between.md)
5657

5758
## 日期信息函数
5859

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: MONTHS_BETWEEN
3+
---
4+
import FunctionDescription from '@site/src/components/FunctionDescription';
5+
6+
<FunctionDescription description="引入或更新: v1.2.307"/>
7+
8+
返回 *date1**date2* 之间的月份数。
9+
10+
## 语法
11+
12+
```sql
13+
MONTHS_BETWEEN( <date1>, <date2> )
14+
```
15+
16+
## 参数
17+
18+
*date1**date2* 可以是 DATE 类型、TIMESTAMP 类型,或两者的混合。
19+
20+
## 返回类型
21+
22+
该函数根据以下规则返回一个 FLOAT 值:
23+
24+
- 如果 *date1* 早于 *date2*,函数返回一个负值;否则,返回一个正值。
25+
26+
```sql title='示例:'
27+
SELECT
28+
MONTHS_BETWEEN('2024-03-15'::DATE,
29+
'2024-02-15'::DATE),
30+
MONTHS_BETWEEN('2024-02-15'::DATE,
31+
'2024-03-15'::DATE);
32+
33+
-[ RECORD 1 ]-----------------------------------
34+
months_between('2024-03-15'::date, '2024-02-15'::date): 1
35+
months_between('2024-02-15'::date, '2024-03-15'::date): -1
36+
```
37+
38+
- 如果 *date1**date2* 落在各自月份的同一天,或者两者都是各自月份的最后一天,结果是整数。否则,函数根据一个31天的月份计算结果的小数部分。
39+
40+
```sql title='示例:'
41+
SELECT
42+
MONTHS_BETWEEN('2024-02-29'::DATE,
43+
'2024-01-29'::DATE),
44+
MONTHS_BETWEEN('2024-02-29'::DATE,
45+
'2024-01-31'::DATE);
46+
47+
-[ RECORD 1 ]-----------------------------------
48+
months_between('2024-02-29'::date, '2024-01-29'::date): 1
49+
months_between('2024-02-29'::date, '2024-01-31'::date): 1
50+
51+
SELECT
52+
MONTHS_BETWEEN('2024-08-05'::DATE,
53+
'2024-01-01'::DATE);
54+
55+
-[ RECORD 1 ]-----------------------------------
56+
months_between('2024-08-05'::date, '2024-01-01'::date): 7.129032258064516
57+
```
58+
59+
- 如果 *date1**date2* 是相同的日期,函数忽略任何时间部分并返回0
60+
61+
```sql title='示例:'
62+
SELECT
63+
MONTHS_BETWEEN('2024-08-05'::DATE,
64+
'2024-08-05'::DATE),
65+
MONTHS_BETWEEN('2024-08-05 02:00:00'::TIMESTAMP,
66+
'2024-08-05 01:00:00'::TIMESTAMP);
67+
68+
-[ RECORD 1 ]-----------------------------------
69+
months_between('2024-08-05'::date, '2024-08-05'::date): 0
70+
months_between('2024-08-05 02:00:00'::timestamp, '2024-08-05 01:00:00'::timestamp): 0
71+
```

0 commit comments

Comments
 (0)