# 金融 / 基本面 / 基本 / 报告期数据获取 / 报告期列表

## `getRDateByYear(t, beg_y, end_y, show_1_q, show_2_q, show_3_q, show_4_q)`

声明：function

返回选取复符合条件的报告期，按照Show1Q，Show2Q，Show3Q，Show4Q是否为真来表示是够选取一季报，中报，年报，选取的年份区间在BegY，EndY内

<!-- tags: 金融 基本面 基本 报告期数据获取 报告期列表 返回 获取 数组 列表 array list 报表 -->

| 参数       | 类型        | 说明                                                                         |
| ---------- | ----------- | ---------------------------------------------------------------------------- |
| `t`        | table_array | 数据表，必须含有”截止日”或者”ReportDate”字段，其字段下的数据必须是报告期日期 |
| `beg_y`    | integer     | 整数，选取的开始年份                                                         |
| `end_y`    | integer     | 整数，选取的结束年份                                                         |
| `show_1_q` | boolean     | 布尔类型，是否选取一季报                                                     |
| `show_2_q` | boolean     | 布尔类型，是否选取中报                                                       |
| `show_3_q` | boolean     | 布尔类型，是否选取三季报                                                     |
| `show_4_q` | boolean     | 布尔类型，是否选取年报                                                       |

返回：array

### 示例

范例01：选取一季报,中报,三季报

```tsl
t := array(("截止日":20120930), ("截止日":20120331), ("截止日":20120923), ("截止日":20120912));
return GetRDateByYear(t, 2012, 2012, 1, 1, 1, 0);
// 选取一季报,中报,三季报
```

## `previousReportDateList(rdate, n, rdatetype)`

声明：function

返回指定报告期前N个报告期序列

<!-- tags: 金融 基本面 基本 报告期数据获取 报告期列表 返回 获取 数组 列表 array list 报表 -->

| 参数        | 类型    | 说明                                 |
| ----------- | ------- | ------------------------------------ |
| `rdate`     | integer | 整型,指定报告期                      |
| `n`         | integer | 整型,向前推N个报告期（为负则向后推） |
| `rdatetype` | integer | 整型,报告期类型                      |

返回：array

### 示例

范例01：调用函数

```tsl
// 20201231的前4个报告期
return previousReportDateList(20201231, 4, 0);
// 输出：array(20200930,20200630,20200331,20191231)
```

## `previousReportDateList2(rdate, n, r_date_type)`

声明：function

返回指定报告期前N个报告期

<!-- tags: 金融 基本面 基本 报告期数据获取 报告期列表 返回 获取 数组 列表 array list 报表 -->

| 参数          | 类型    | 说明                                 |
| ------------- | ------- | ------------------------------------ |
| `rdate`       | integer | 报告期,指定报告期                    |
| `n`           | integer | 整数,向前推N个报告期（为负则向后推） |
| `r_date_type` | integer | 用户自定义,报告期类型                |

返回：date

### 示例

范例01：调用函数

```tsl
// 20191231的前1个报告期
return previousReportDateList2(20191231, 1, 0);
// 输出：array(20190930)
```

## `rDateListBetween(t, beg_r_date, end_r_date, key_field, sort_order, r_date_type)`

声明：function

返回指定区间的报告期数据

<!-- tags: 金融 基本面 基本 报告期数据获取 报告期列表 排序 sort 返回 获取 数组 列表 array -->

| 参数          | 类型    | 说明                                  |
| ------------- | ------- | ------------------------------------- |
| `t`           | array   | 数组。数据                            |
| `beg_r_date`  | integer | 整数。起始报告期                      |
| `end_r_date`  | integer | 整数。截止报告期                      |
| `key_field`   | string  | 字符串。关键字段                      |
| `sort_order`  | integer | 用户自定义。排序，取值如下:           |
| `r_date_type` | integer | 用户自定义。返回报告期类型，取值如下: |

返回：array

## `rDateListQK(begt, endt, r_date_type)`

声明：function

返回区间报告期序列

<!-- tags: 金融 基本面 基本 报告期数据获取 报告期列表 返回 获取 数组 列表 array list 报表 -->

| 参数          | 类型        | 说明                                  |
| ------------- | ----------- | ------------------------------------- |
| `begt`        | t_date_time | 日期。开始日                          |
| `endt`        | t_date_time | 日期。截止日                          |
| `r_date_type` | integer     | 用户自定义。返回报告期类型，取值如下: |

返回：array

### 示例

范例01：调用 RDateListQK

```tsl
return RDateListQK(20111231T, 20130630T, 0);
```

## `wordRDateShowField(r_date, cr_date)`

声明：function

返回Word中报告期显示格式1

<!-- tags: 金融 基本面 基本 报告期数据获取 报告期列表 返回 获取 数组 列表 array list 报表 -->

| 参数      | 类型    | 说明             |
| --------- | ------- | ---------------- |
| `r_date`  | integer | 整数。报告期     |
| `cr_date` | integer | 整数。最新报告期 |

返回：string

### 示例

范例01：调用函数

```tsl
return wordRDateShowField(20121231, 20130630);
// 输出：2012A
```

## `wordRDateShowField2(r_date)`

声明：function

返回Word中报告期显示格式2

<!-- tags: 金融 基本面 基本 报告期数据获取 报告期列表 返回 获取 数组 列表 array list 报表 -->

| 参数     | 类型    | 说明         |
| -------- | ------- | ------------ |
| `r_date` | integer | 整数。报告期 |

返回：string

### 示例

范例01：调用函数

```tsl
return wordRDateShowField2(20121231);
// 输出：2012
```
