# 金融函数 - 股票 / 分红送配

## 函数

### `stockPfAndRatioInfo3(r_date, return_type)`

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

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

返回：array

### `stockBuyandHoldReturn(beg_t, end_t)`

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

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

返回：float

### `stockDividendYieldRatio(end_t)`

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

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

返回：float

### `stockDistributionInfo(beg_t, end_t)`

返回一段时间的配股详情

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

返回：array

### `stockDistributionInfo2()`

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

返回：array

### `stockDistributionInfo3(r_date, return_type)`

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

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

返回：array

### `stockPfAmount(beg_t, end_t)`

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

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

返回：float

### `stockPfAmount2()`

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

返回：float

### `stockPfInfo(beg_t, end_t)`

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

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

返回：array

### `stockPfInfo2()`

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

返回：array

### `stockPfInfo3(r_date, return_type)`

报告期分红情况

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

返回：array

### `stockPfRatioInfo(beg_t, end_t)`

区间送股情况

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

返回：array

### `stockPfRatioInfo2()`

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

返回：array

### `stockPfAmountOfYear(year)`

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

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

返回：float

### `stockPfAmountOfRDate(r_date)`

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

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

返回：float

### `stockPfps(beg_t, end_t)`

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

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

返回：float

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

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

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

返回：float

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

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

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

返回：float

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

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

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

返回：array

### `stockPfRatio(beg_t, end_t)`

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

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

返回：float