# 股票 / 分红送配

## `BK_DividendAmountOfEndt(endt)`

声明：function

板块指定日分红总额（除权除息日），与系统参数（pn_bk()）相关。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `endt` | datetime | 日期。截止日 |

返回：float

## `BK_DividendAmountOfEndtQJ(begt, endt)`

声明：function

板块指定区间分红总额（除权除息日），与系统参数（pn_bk()）相关。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `begt` | datetime | 日期。开始日 |
| `endt` | datetime | 日期。截止日 |

返回：float

## `BK_DividendAmountOfRdate(rdate)`

声明：function

板块报告期分红总额，与系统参数（pn_bk()）相关。

| 参数    | 类型     | 说明             |
| ------- | -------- | ---------------- |
| `rdate` | datetime | 整数。开始报告期 |

返回：float

## `BK_DividendAmountOfRdateQJ(rdate, rdate2, is_special_rdate)`

声明：function

板块报告期区间分红总额，与系统参数（pn_bk()）相关。截止日在Rdate与Rdate2之间的分红总额。若取整年数据如2023年，可将开始报告期设置20230101，截止报告期20231231。

| 参数               | 类型     | 说明                                                                            |
| ------------------ | -------- | ------------------------------------------------------------------------------- |
| `rdate`            | datetime | 整数。开始报告期                                                                |
| `rdate2`           | any      | 整数。截止报告期                                                                |
| `is_special_rdate` | any      | 整数。是否考虑特殊分红，非报告期可能会发生分红送股行为，默认为0，不考虑特殊分红 |

返回：float

## `stockBonusShareRateOfEndt(endt)`

声明：function

指定日红股比（除权除息日），与系统函数(证券代码)相关。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockBonusShareRateOfEndt(20240401T);
```

## `stockBonusShareRateOfEndtQj(begt, endt)`

声明：function

区间红股比。与系统函数(证券代码)相关。除权除息日在Begt与endt之间的红股比。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `begt` | datetime | 日期。开始日 |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockBonusShareRateOfEndtQJ(20240101T,20240430T);
```

## `stockBonusShareRateOfRdate(rdate)`

声明：function

报告期红股比，与系统函数(证券代码)相关。

| 参数    | 类型 | 说明             |
| ------- | ---- | ---------------- |
| `rdate` | int  | 整数。开始报告期 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ300585");
return StockBonusShareRateOfRdate(20161231);
```

## `stockBonusShareRateOfRdateQj(rdate, rdate2, is_special_rdate)`

声明：function

报告期区间红股比，与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的红股比。若取整年数据如2023年，可将开始报告期设置20230101，截止报告期20231231。

| 参数               | 类型 | 说明                                                                            |
| ------------------ | ---- | ------------------------------------------------------------------------------- |
| `rdate`            | int  | 整数。开始报告期                                                                |
| `rdate2`           | int  | 整数。截止报告期                                                                |
| `is_special_rdate` | int  | 整数。是否考虑特殊分红，非报告期可能会发生分红送股行为，默认为0，不考虑特殊分红 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockBonusShareRateOfRdateQJ(20230101,20231231);
```

## `stockBuyandHoldReturn(beg_t, end_t)`

声明：function

提取股票的持仓不动收益率(%)，与系统股票pn_stock()、当前时间pn_date()、周期pn_cycle()，除权方式pn_rate()相关。

| 参数    | 类型     | 说明                 |
| ------- | -------- | -------------------- |
| `beg_t` | datetime | 日期类型，开始日期； |
| `end_t` | datetime | 日期类型，截止日期   |

返回：float

### 示例

```tsl
setsysparam(pn_stock(),'SZ000002');
Return StockBuyandHoldReturn(20180827T,20180903T);
```

## `stockConversionRateOfEndt(endt)`

声明：function

指定日转增比（除权除息日），与系统函数(证券代码)相关。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockConversionRateOfEndt(20240401T);
```

## `stockConversionRateOfEndtQj(begt, endt)`

声明：function

区间转增比，与系统函数(证券代码)相关。除权除息日在Begt与endt之间的转增比。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `begt` | datetime | 日期。开始日 |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockConversionRateOfEndtQJ(20240101T,20240430T);
```

## `stockConversionRateOfRdate(rdate)`

声明：function

报告期转增比，与系统函数(证券代码)相关。

| 参数    | 类型 | 说明             |
| ------- | ---- | ---------------- |
| `rdate` | int  | 整数。开始报告期 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ300585");
return StockConversionRateOfRdate(20161231);
```

## `stockConversionRateOfRdateQj(rdate, rdate2, is_special_rdate)`

声明：function

报告期区间转增比，与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的转增比。若取整年数据如2023年，可将开始报告期设置20230101，截止报告期20231231。

| 参数               | 类型 | 说明                                                                            |
| ------------------ | ---- | ------------------------------------------------------------------------------- |
| `rdate`            | int  | 整数。开始报告期                                                                |
| `rdate2`           | int  | 整数。截止报告期                                                                |
| `is_special_rdate` | int  | 整数。是否考虑特殊分红，非报告期可能会发生分红送股行为，默认为0，不考虑特殊分红 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockConversionRateOfRdateQJ(20230101,20231231);
```

## `stockDistributionInfo(beg_t, end_t)`

声明：function

返回一段时间的配股详情

| 参数    | 类型     | 说明             |
| ------- | -------- | ---------------- |
| `beg_t` | datetime | 实数，起始日期； |
| `end_t` | datetime | 实数，截止日期； |

返回：array

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000759');
v:=StockDistributionInfo(inttodate(20000101),inttodate(20120830));
return v;
```

## `stockDistributionInfo2()`

声明：function

上市以来截止当前时间（与除权日比较）的配股详情，与当前股票、当前时间相关。

返回：array

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000759');
setsysparam(pn_date(),20101221T);
v:=StockDistributionInfo2();
return v;
```

## `stockDistributionInfo3(r_date, return_type)`

声明：function

返回指定报告期的配股情况

| 参数          | 类型 | 说明             |
| ------------- | ---- | ---------------- |
| `r_date`      | int  | 整数，报告期；   |
| `return_type` | int  | 整数，返回类型； |

返回：array

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000759');
v:=StockDistributionInfo3(20081231,0);
return v;
```

## `StockDistributionInfo_AdvanceDate(r_date)`

声明：function

报告期配股情况\_预案。 配股预案的数据可以从配股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `StockDistributionInfo_DecisionDeclareDate(r_date)`

声明：function

报告期配股情况\_决案。 配股决案的数据从配股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `StockDistributionInfo_ExDate(r_date)`

声明：function

报告期配股情况\_实施。 配股实施数据从配股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `stockDividendAmountOfEndt(endt)`

声明：function

指定日分红总额（除权除息日），与系统函数(证券代码)相关。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendAmountOfEndt(20230620T);
```

## `stockDividendAmountOfEndtQj(begt, endt)`

声明：function

区间分红总额，与系统函数(证券代码)相关。除权除息日在Begt与endt之间的分红总额。 某次分红总额通过分红送股基数\*红利比获得。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `begt` | datetime | 日期。开始日 |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendAmountOfEndtQJ(20230101T,20231231T);
```

## `stockDividendAmountOfRdate(rdate)`

声明：function

报告期分红总额，与系统函数(证券代码)相关。

| 参数    | 类型 | 说明             |
| ------- | ---- | ---------------- |
| `rdate` | int  | 整数。开始报告期 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendAmountOfRdate(20231231);
```

## `stockDividendAmountOfRdateQj(rdate, rdate2, is_special_rdate)`

声明：function

报告期区间分红总额，与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的分红总额。若取整年数据如2023年，可将开始报告期设置20230101，截止报告期20231231。

| 参数               | 类型 | 说明                                                                            |
| ------------------ | ---- | ------------------------------------------------------------------------------- |
| `rdate`            | int  | 整数。开始报告期                                                                |
| `rdate2`           | int  | 整数。截止报告期                                                                |
| `is_special_rdate` | int  | 整数。是否考虑特殊分红，非报告期可能会发生分红送股行为，默认为0，不考虑特殊分红 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendAmountOfRdateQJ(20230101,20231231);
```

## `stockDividendRateAfterTaxOfEndt(endt)`

声明：function

指定日实得比（除权除息日），与系统函数(证券代码)相关。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendRateAfterTaxOfEndt(20230620T);
```

## `stockDividendRateAfterTaxOfEndtQj(begt, endt)`

声明：function

区间实得比，与系统函数(证券代码)相关。除权除息日在Begt与endt之间的实得比求和。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `begt` | datetime | 日期。开始日 |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendRateAfterTaxOfEndtQJ(20230101T,20231231T);
```

## `stockDividendRateAfterTaxOfRdate(rdate)`

声明：function

报告期实得比，与系统函数(证券代码)相关。

| 参数    | 类型 | 说明             |
| ------- | ---- | ---------------- |
| `rdate` | int  | 整数。开始报告期 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendRateAfterTaxOfRdate(20231231);
```

## `stockDividendRateAfterTaxOfRdateQj(rdate, rdate2, is_special_rdate)`

声明：function

报告期区间实得比，与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的实得比求和。若取整年数据如2023年，可将开始报告期设置20230101，截止报告期20231231。

| 参数               | 类型 | 说明                                                                            |
| ------------------ | ---- | ------------------------------------------------------------------------------- |
| `rdate`            | int  | 整数。开始报告期                                                                |
| `rdate2`           | int  | 整数。截止报告期                                                                |
| `is_special_rdate` | int  | 整数。是否考虑特殊分红，非报告期可能会发生分红送股行为，默认为0，不考虑特殊分红 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendRateAfterTaxOfRdateQJ(20230101,20231231);
```

## `stockDividendRateOfEndt(endt)`

声明：function

指定日红利比（除权除息日），与系统函数(证券代码)相关。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendRateOfEndt(20230620T);
```

## `stockDividendRateOfEndtQj(begt, endt)`

声明：function

区间红利比，与系统函数(证券代码)相关。除权除息日在Begt与endt之间的红利比求和。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `begt` | datetime | 日期。开始日 |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendRateOfEndtQJ(20230101T,20231231T);
```

## `stockDividendRateOfRdate(rdate)`

声明：function

报告期红利比，与系统函数(证券代码)相关。

| 参数    | 类型 | 说明             |
| ------- | ---- | ---------------- |
| `rdate` | int  | 整数。开始报告期 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendRateOfRdate(20231231);
```

## `stockDividendRateOfRdateQj(rdate, rdate2, is_special_rdate)`

声明：function

报告期区间分红比，与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的红利比求和。若取整年数据如2023年，可将开始报告期设置20230101，截止报告期20231231。

| 参数               | 类型 | 说明                                                                            |
| ------------------ | ---- | ------------------------------------------------------------------------------- |
| `rdate`            | int  | 整数。开始报告期                                                                |
| `rdate2`           | int  | 整数。截止报告期                                                                |
| `is_special_rdate` | int  | 整数。是否考虑特殊分红，非报告期可能会发生分红送股行为，默认为0，不考虑特殊分红 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SH600585");
return StockDividendRateOfRdateQJ(20230101,20231231);
```

## `stockDividendYieldRatio(end_t)`

声明：function

提取股票的指定日股息收益率(%)(最近12个月,按除息日)，与系统股票pn_stock()、当前时间pn_date()相关。

| 参数    | 类型     | 说明                 |
| ------- | -------- | -------------------- |
| `end_t` | datetime | 日期类型，截止日期； |

返回：float

### 示例

```tsl
setsysparam(pn_stock(),'SZ000002');
Return StockDividendYieldRatio(20180822T);
```

## `stockFhspInfoExt(date_by, beg_t, end_t)`

声明：function

区间分红送股详情。 统计当前股票从开始日期到截止日期之间的分红送股数据。该数据从分红送股表中取得。

| 参数      | 类型     | 说明                |
| --------- | -------- | ------------------- |
| `date_by` | datetime | 日期类型；取值如下: |
| `beg_t`   | datetime | 实数，起始日期；    |
| `end_t`   | datetime | 实数，截止日期；    |

返回：array

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockFHSPInfoExt (0,20120101,20120830);
return v;
```

## `StockLJFH(beg_t, end_t, v_gqfz)`

声明：function

统计从开始日期到截止日期的每股累计分红（只考虑分红、送股、转增，不考虑配股、增发）。

| 参数     | 类型      | 说明             |
| -------- | --------- | ---------------- |
| `beg_t`  | TDateTime | 实数，起始日期； |
| `end_t`  | TDateTime | 实数，截止日期； |
| `v_gqfz` | Boolean   | 考虑股权分置；   |

返回：Real，实数，每股累计分红。

## `StockLJFH_(beg_t, end_t, v_gqfz, return_type)`

声明：function

假设以开始日收盘买入股票，考察累计分红占初始投资的比例（只考虑分红、送股、转增，不考虑配股、增发） （1）如果指定日上市，则假设买入价格为当日收盘价； （2）如果指定日没有上市，则假设买入价格为上市首日的收盘价； （3）ReturnType=0时，取每股区间累计分红/初始投资； ReturnType=1是，取每股区间累计分红。

| 参数          | 类型     | 说明             |
| ------------- | -------- | ---------------- |
| `beg_t`       | datetime | 实数，起始日期； |
| `end_t`       | datetime | 实数，截止日期； |
| `v_gqfz`      | bool     | object           |
| `return_type` | any      | 整数，返回类型； |

返回：float

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockLJFH(20020101T,20120830T,true);
return v;
```

## `stockLjfhPercent(beg_t, end_t, v_gqfz)`

声明：function

假设以开始日收盘买入股票，考察每股累计分红占初始投资的比例（只考虑分红、送股、转增，不考虑配股、增发）。 （1）如果指定日上市，则假设买入价格为当日收盘价，即初始投资； （2）如果指定日没有上市，则假设买入价格为上市首日的收盘价，即初始投资。

| 参数     | 类型     | 说明             |
| -------- | -------- | ---------------- |
| `beg_t`  | datetime | 实数，起始日期； |
| `end_t`  | datetime | 实数，截止日期； |
| `v_gqfz` | bool     | object           |

返回：float

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockLJFHPercent(20020101T,20120830T,true);
return v;
```

## `stockPfAmount(beg_t, end_t)`

声明：function

区间分红总额(万)，统计起始日期到截止日期之间的分红总额。某次分红总额通过除权除息日的总股本\*红利比获得。

| 参数    | 类型     | 说明             |
| ------- | -------- | ---------------- |
| `beg_t` | datetime | 实数，起始日期； |
| `end_t` | datetime | 实数，截止日期； |

返回：float

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFAmount(inttodate(20120101),inttodate(20120830));
return v;
```

## `stockPfAmount2()`

声明：function

统计上市至系统当前时间（默认今天）的分红总额，单位万。某次分红总额通过除权除息日的总股本\*红利比获得。 系统参数：pn_stock()、pn_date()

返回：float

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
setsysparam(pn_date(),20171231T);
v:=StockPFAmount2();
return v;
```

## `stockPfAmountOfRDate(r_date)`

声明：function

报告期分红总额(万)=每股股利\*总股本/10000。 每股股利，即分红送股表的红利比。总股本即指定报告期的总股本。

| 参数     | 类型 | 说明           |
| -------- | ---- | -------------- |
| `r_date` | int  | 整数，报告期； |

返回：float

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFAmountOfRDate(20111231);
return v;
```

## `stockPfAmountOfYear(year)`

声明：function

年度分红总额(万)=∑(每股股利\*总股本)/10000

| 参数   | 类型 | 说明         |
| ------ | ---- | ------------ |
| `year` | any  | 整数，年份； |

返回：float

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFAmountOfYear(2011);
return v;
```

## `stockPfAndRatioInfo3(r_date, return_type)`

声明：function

提取股票的指定报告期的报告期分红送股情况，与系统股票pn_stock()、当前时间pn_date()相关。

| 参数          | 类型     | 说明                 |
| ------------- | -------- | -------------------- |
| `r_date`      | datetime | 报告期类型，报告期； |
| `return_type` | int      | 整数，返回类型；     |

返回：array

### 示例

```tsl
setsysparam(pn_stock(),'SZ000002');
Return StockPFAndRatioInfo3(20171231,0);
```

## `StockPFAndRatioInfo_ExDate(r_date)`

声明：function

报告期分红送股情况\_实施。 分红送股实施数据从分红送股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `stockPfInfo(beg_t, end_t)`

声明：function

返回指定股票区间分红详情，该函数和证券代码有关。

| 参数    | 类型     | 说明             |
| ------- | -------- | ---------------- |
| `beg_t` | datetime | 实数，起始日期； |
| `end_t` | datetime | 实数，截止日期； |

返回：array

### 示例

```tsl
{取得SH600005(武钢股份)在20110113与20110913区间分红详情;}
SetSysParam(pn_stock(),'SH600005');
BegT:=inttodate(20110113);
EndT:=inttodate(20110913);
return?StockPFInfo(BegT,EndT);
```

## `stockPfInfo2()`

声明：function

返回指定股票上市以来截止当前时间（除权除息日）的分红情况，该函数和证券代码、当前时间有关。

返回：array

### 示例

```tsl
SetSysParam(pn_stock(),'SH600635');
setsysparam(pn_date(),20111202T);
return StockPFInfo2();
```

## `stockPfInfo3(r_date, return_type)`

声明：function

报告期分红情况

| 参数          | 类型 | 说明           |
| ------------- | ---- | -------------- |
| `r_date`      | int  | 整数，报告期； |
| `return_type` | int  | 返回类型；     |

返回：array

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFInfo3(20111231,0);
return v;
```

## `StockPFInfo_AdvanceDate(r_date)`

声明：function

报告期分红情况\_预案。 分红情况数据从分红送股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `StockPFInfo_DecisionDeclareDate(r_date)`

声明：function

报告期分红情况\_决案。 分红情况数据从分红送股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `StockPFInfo_ExDate(r_date)`

声明：function

报告期分红情况\_实施。 分红情况数据从分红送股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `stockPfps(beg_t, end_t)`

声明：function

区间分红（元/股）=Σ每股派现（税前）； 每股派现（税前），即分红送股表的红利比；每股派现（税后），即分红送股表的实得比。

| 参数    | 类型     | 说明             |
| ------- | -------- | ---------------- |
| `beg_t` | datetime | 实数，起始日期； |
| `end_t` | datetime | 实数，截止日期； |

返回：float

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFPS (inttodate(20120101),inttodate(20120809));
return v;
```

## `stockPfRatio(beg_t, end_t)`

声明：function

获取当前证券区间送股比，与系统参数(股票)相关。允许通过系统时间设置EndT(函数EndT不设置)。

| 参数    | 类型     | 说明           |
| ------- | -------- | -------------- |
| `beg_t` | datetime | 日期。开始日期 |
| `end_t` | datetime | 日期。截止日期 |

返回：float

### 示例

```tsl
SetSysParam(PN_Stock(),'SZ000002');
return StockPFRatio(20200801T,20230801T);
```

## `stockPfRatioInfo(beg_t, end_t)`

声明：function

区间送股情况

| 参数    | 类型     | 说明             |
| ------- | -------- | ---------------- |
| `beg_t` | datetime | 实数，起始日期； |
| `end_t` | datetime | 实数，截止日期； |

返回：array

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFRatioInfo (inttodate(20060101),inttodate(20071231));
return v;
```

## `stockPfRatioInfo2()`

声明：function

上市以来截止到当前时间（按除权日）的送股情况，与当前证券、当前时间相关。

返回：array

### 示例

```tsl
oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SH600000');
setsysparam(pn_date(),20111202T);
v:=StockPFRatioInfo2();
return v;
```

## `StockPFRatioInfo_AdvanceDate(r_date)`

声明：function

报告期送股情况\_预案。 送股情况数据从分红送股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `StockPFRatioInfo_DecisionDeclareDate(r_date)`

声明：function

报告期送股情况\_决案 送股情况数据从分红送股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `StockPFRatioInfo_ExDate(r_date)`

声明：function

报告期送股情况\_实施。 送股情况数据从分红送股表中取得。

| 参数     | 类型     | 说明           |
| -------- | -------- | -------------- |
| `r_date` | datetime | 整数，报告期； |

返回：array

## `stockPfRatioOfEndt(endt)`

声明：function

指定日送股比（除权除息日），与系统函数(证券代码)相关。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockPFRatioOfEndt(20240401T);
```

## `stockPfRatioOfEndtQj(begt, endt)`

声明：function

区间送股比，与系统函数(证券代码)相关。除权除息日在Begt与endt之间的送股比。

| 参数   | 类型     | 说明         |
| ------ | -------- | ------------ |
| `begt` | datetime | 日期。开始日 |
| `endt` | datetime | 日期。截止日 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockPFRatioOfEndtQJ(20240101T,20240430T);
```

## `stockPfRatioOfRdate(rdate)`

声明：function

报告期送股比，与系统函数(证券代码)相关。

| 参数    | 类型 | 说明             |
| ------- | ---- | ---------------- |
| `rdate` | int  | 整数。开始报告期 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ300585");
return StockPFRatioOfRdate(20161231);
```

## `stockPfRatioOfRdateQj(rdate, rdate2, is_special_rdate)`

声明：function

报告期区间送股比。与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的送股比。若取整年数据如2023年，可将开始报告期设置20230101，截止报告期20231231。

| 参数               | 类型 | 说明                                                                            |
| ------------------ | ---- | ------------------------------------------------------------------------------- |
| `rdate`            | int  | 整数。开始报告期                                                                |
| `rdate2`           | int  | 整数。截止报告期                                                                |
| `is_special_rdate` | int  | 整数。是否考虑特殊分红，非报告期可能会发生分红送股行为，默认为0，不考虑特殊分红 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),"SZ301052");
return StockPFRatioOfRdateQJ(20230101,20231231);
```

## `Stocks_DividendAmountOfEndt(stockarr, endt)`

声明：function

股票列表指定日分红总额。

| 参数       | 类型     | 说明               |
| ---------- | -------- | ------------------ |
| `stockarr` | array    | 数组。证券代码列表 |
| `endt`     | datetime | 日期。截止日       |

返回：array

## `Stocks_DividendAmountOfEndtQJ(stockarr, begt, endt)`

声明：function

股票列表区间分红总额。除权除息日在begt与endt之间的分红总额。

| 参数       | 类型     | 说明               |
| ---------- | -------- | ------------------ |
| `stockarr` | array    | 数组。证券代码列表 |
| `begt`     | datetime | 日期。开始日       |
| `endt`     | datetime | 日期。截止日       |

返回：array

## `Stocks_DividendAmountOfRdate(stockarr, rdate)`

声明：function

股票列表指定报告期分红总额。

| 参数       | 类型     | 说明               |
| ---------- | -------- | ------------------ |
| `stockarr` | array    | 数组。证券代码列表 |
| `rdate`    | datetime | 整数。开始报告期   |

返回：array

## `Stocks_DividendAmountOfRdateQJ(stockarr, rdate, rdate2, is_special_rdate)`

声明：function

股票列表报告期区间分红总额。截止日在Rdate与Rdate2之间的分红总额。

| 参数               | 类型     | 说明                                                                            |
| ------------------ | -------- | ------------------------------------------------------------------------------- |
| `stockarr`         | array    | 数组。证券代码列表                                                              |
| `rdate`            | datetime | 整数。开始报告期                                                                |
| `rdate2`           | any      | 整数。截止报告期                                                                |
| `is_special_rdate` | any      | 整数。是否考虑特殊分红，非报告期可能会发生分红送股行为，默认为0，不考虑特殊分红 |

返回：array

## `stockPfRatioInfo3(r_date, return_type)`

声明：function

报告期送股情况

| 参数          | 类型    | 说明             |
| ------------- | ------- | ---------------- |
| `r_date`      | Integer | 整数，报告期；   |
| `return_type` | Integer | 整数，返回类型； |

返回：Array

### 示例

```tsl
o_v:=BackUpSystemParameters2();
//取'昊华能源'在2011年年报的报告期送股情况；
setSysParam(pn_stock(),'SH601101');
v:=stockPfRatioInfo3(20111231,0);
return v;
//结果：
```