# 金融 / 财务分析 / 投资收益

## `dividendYield(r_date)`

声明：function

返回普通股获利率(%)

<!-- tags: 金融 财务分析 投资收益 返回 获取 -->

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

返回：real

### 示例

范例01：2024年年报格力电器的普通股获利率(%)

```tsl
// 2024年年报格力电器的普通股获利率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(pn_date(), 20250828t);

v := DividendYield(20241231);

return v;
// 输出：4.2328
```

范例02：2024年年报格力电器的普通股获利率(%)的TTM

```tsl
// 2024年年报格力电器的普通股获利率(%)的TTM

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(pn_date(), 20250828t);

SetSysParam(CT_TTMData(), True); // 计算TTM

v := DividendYield(20241231);

return v;
// 输出：6.3605
```

范例03：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的普通股获利率(%)

```tsl
// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的普通股获利率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(pn_date(), 20250828t);

setsysparam(CT_YearData(), true); // 计算最近会计年度

setsysparam(CT_RecentYear(), 1); // 最近1年

v := DividendYield(20240331);

return v;
// 输出：5.064
```

## `dividendYield3(report_date)`

声明：function

返回股息支付率(%)

<!-- tags: 金融 财务分析 投资收益 返回 获取 -->

| 参数          | 类型    | 说明         |
| ------------- | ------- | ------------ |
| `report_date` | integer | 整数，报告期 |

返回：real

### 示例

范例01：2024年年报格力电器的股息支付率(%)

```tsl
// 2024年年报格力电器的股息支付率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := DividendYield3(20241231);

return v;
// 输出：34.808
```

范例02：2024年年报格力电器的股息支付率(%)的TTM

```tsl
// 2024年年报格力电器的股息支付率(%)的TTM

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

SetSysParam(CT_TTMData(), True); // 计算TTM

v := DividendYield3(20241231);

return v;
// 输出：52.3052
```

范例03：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的股息支付率(%)

```tsl
// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的股息支付率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(CT_YearData(), true); // 计算最近会计年度

setsysparam(CT_RecentYear(), 1); // 最近1年

v := DividendYield3(20240331);

return v;
// 输出：46.1887
```

范例04：取2016年年报格力电器的股息支付率(%)调整前与调整后

```tsl
// 取2016年年报格力电器的股息支付率(%)调整前与调整后

// 20180426公布的2017年年报对2016年年报中的归属母公司所有者净利润数据进行了调整

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

RDate := 20161231;

// 调整前：设置指定日早于调整后公布日

setsysparam(pn_date(), 20171231T);

v1 := DividendYield3(RDate);

// 调整后：设置指定日晚于调整后公布日

setsysparam(pn_date(), 20181231T);

v2 := DividendYield3(RDate);

return array(v1, v2); // array(70.2181,70.0244)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
```

## `dividendYield4(report_date)`

声明：function

返回股利保障倍数

<!-- tags: 金融 财务分析 投资收益 返回 获取 -->

| 参数          | 类型    | 说明         |
| ------------- | ------- | ------------ |
| `report_date` | integer | 整数，报告期 |

返回：real

### 示例

范例01：2024年年报格力电器的股利保障倍数

```tsl
// 2024年年报格力电器的股利保障倍数

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := DividendYield4(20241231);

return v;
// 输出：2.8729
```

范例02：2024年年报格力电器的股利保障倍数的TTM

```tsl
// 2024年年报格力电器的股利保障倍数的TTM

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

SetSysParam(CT_TTMData(), True); // 计算TTM

v := DividendYield4(20241231);

return v;
// 输出：1.9119
```

范例03：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的股利保障倍数

```tsl
// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的股利保障倍数

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(CT_YearData(), true); // 计算最近会计年度

setsysparam(CT_RecentYear(), 1); // 最近1年

v := DividendYield4(20240331);

return v;
// 输出：2.165
```

范例04：取2016年年报格力电器的股利保障倍数调整前与调整后

```tsl
// 取2016年年报格力电器的股利保障倍数调整前与调整后

// 20180426公布的2017年年报对2016年年报中的归属母公司所有者净利润数据进行了调整

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

RDate := 20161231;

// 调整前：设置指定日早于调整后公布日

setsysparam(pn_date(), 20171231T);

v1 := DividendYield4(RDate);

// 调整后：设置指定日晚于调整后公布日

setsysparam(pn_date(), 20181231T);

v2 := DividendYield4(RDate);

return array(v1, v2); // array(1.4241,1.4281)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
```

## `dividendYield5(report_date)`

声明：function

返回留存盈利比率(%)

<!-- tags: 金融 财务分析 投资收益 返回 获取 -->

| 参数          | 类型    | 说明         |
| ------------- | ------- | ------------ |
| `report_date` | integer | 整数，报告期 |

返回：real

### 示例

范例01：2024年年报格力电器的留存盈利比率(%)

```tsl
// 2024年年报格力电器的留存盈利比率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := DividendYield5(20241231);

return v;
// 输出：65.192
```

范例02：2024年年报格力电器的留存盈利比率(%)的TTM

```tsl
// 2024年年报格力电器的留存盈利比率(%)的TTM

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

SetSysParam(CT_TTMData(), True); // 计算TTM

v := DividendYield5(20241231);

return v;
// 输出：47.6948
```

范例03：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的留存盈利比率(%)

```tsl
// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的留存盈利比率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(CT_YearData(), true); // 计算最近会计年度

setsysparam(CT_RecentYear(), 1); // 最近1年

v := DividendYield5(20240331);

return v;
// 输出：53.8113
```

范例04：取2016年年报格力电器的留存盈利比率(%)调整前与调整后

```tsl
// 取2016年年报格力电器的留存盈利比率(%)调整前与调整后

// 20180426公布的2017年年报对2016年年报中的归属母公司所有者净利润数据进行了调整

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

RDate := 20161231;

// 调整前：设置指定日早于调整后公布日

setsysparam(pn_date(), 20171231T);

v1 := DividendYield5(RDate);

// 调整后：设置指定日晚于调整后公布日

setsysparam(pn_date(), 20181231T);

v2 := DividendYield5(RDate);

return array(v1, v2); // array(29.7819,29.9756)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
```

## `dividendYield6(report_date, end_t)`

声明：function

返回普通股获利率(%)

<!-- tags: 金融 财务分析 投资收益 返回 获取 -->

| 参数          | 类型    | 说明                 |
| ------------- | ------- | -------------------- |
| `report_date` | integer | 整数，报告期；       |
| `end_t`       | date    | 日期型，计算获利日期 |

返回：real

### 示例

范例01：2024年年报，获利日期为20250828，取格力电器的普通股获利率(%)

```tsl
// 2024年年报，获利日期为20250828，取格力电器的普通股获利率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := DividendYield6(20241231, 20250828t);

return v;
// 输出：4.2328
```

范例02：2024年年报，获利日期为20250828，取格力电器的普通股获利率(%)的TTM

```tsl
// 2024年年报，获利日期为20250828，取格力电器的普通股获利率(%)的TTM

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

SetSysParam(CT_TTMData(), True); // 计算TTM

v := DividendYield6(20241231, 20250828t);

return v;
// 输出：6.3605
```

范例03：指定2024年一季报，获利日期为20250828，取格力电器在报告期时的最近1年的会计年度报告期的普通股获利率(%)

```tsl
// 指定2024年一季报，获利日期为20250828，取格力电器在报告期时的最近1年的会计年度报告期的普通股获利率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(CT_YearData(), true); // 计算最近会计年度

setsysparam(CT_RecentYear(), 1); // 最近1年

v := DividendYield6(20240331, 20250828t);

return v;
// 输出：5.064
```

## `dividendYield_year(year, end_t)`

声明：function

返回指定证券年度普通股获利率(%)，与系统参数(股票)相关

<!-- tags: 金融 财务分析 投资收益 返回 获取 -->

| 参数    | 类型     | 说明                 |
| ------- | -------- | -------------------- |
| `year`  | integer  | 整数。年度           |
| `end_t` | datetime | 日期。计算获利率日期 |

返回：float

### 示例

范例01：万科A在2020年度的普通股获利率(%)

```tsl
// 万科A在2020年度的普通股获利率(%)

setsysparam(pn_stock(), 'SZ000002');

return DividendYield_Year(2020, 20210422T);
// 输出：4.30737422467264
```

## `investIncomeRatio(r_date)`

声明：function

计算投资收益率（%），公式为投资收益/（长期投资合计+短期投资+长期投资合计+短期投资）/2 \*100

<!-- tags: 金融 财务分析 投资收益 计算 求解 -->

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

返回：real

### 示例

范例01：调用函数

```tsl
// 指定2011年报，取万科A投资收益率(%)
o_v := BackUpSystemParameters2();
setSysParam(pn_stock(), 'SZ000002');
v := investIncomeRatio (20111231);
return v;
// 输出：10.75
```

## `netAssetAdjust(r_date)`

声明：function

计算调整后的净资产，公式为归属母公司股东权益合计-三年以上的应收帐款-待摊费用-待处理流动资产净损失-待处理固定资产净损失-开办费-长期待摊费用（其中三年以上应收账款设置为0）

<!-- tags: 金融 财务分析 投资收益 计算 求解 -->

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

返回：real

### 示例

范例01：调用函数

```tsl
// 指定2011年报，取万科A调整后的净资产
o_v := BackUpSystemParameters2();
setSysParam(pn_stock(), 'SZ000002');
v := netAssetAdjust (20111231);
return v;
// 输出：52926795650.96
```

## `netAssetRatio(report_date)`

声明：function

计算净资产报酬率(%)，公式为净利润/平均净资产\*100

<!-- tags: 金融 财务分析 投资收益 计算 求解 -->

| 参数          | 类型    | 说明         |
| ------------- | ------- | ------------ |
| `report_date` | integer | 整数，报告期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 指定2011年报，取万科A净资产报酬率(%)
o_v := BackUpSystemParameters2();
setSysParam(pn_stock(), 'SZ000002');
v := netAssetRatio (20111231);
return v;
// 输出：18.17
```

## `sustainableGrowRatio(r_date)`

声明：function

返回可持续增长率(%)，与系统参数(证券代码)相关

<!-- tags: 金融 财务分析 投资收益 返回 获取 -->

| 参数     | 类型    | 说明              |
| -------- | ------- | ----------------- |
| `r_date` | integer | 报告期,指定报告期 |

返回：real

### 示例

范例01：2024年年报格力电器的可持续增长率(%)

```tsl
// 2024年年报格力电器的可持续增长率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := SustainableGrowRatio(20241231);

return v;
// 输出：15.2687
```

范例02：2024年年报格力电器的可持续增长率(%)的TTM

```tsl
// 2024年年报格力电器的可持续增长率(%)的TTM

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

SetSysParam(CT_TTMData(), True); // 计算TTM

v := SustainableGrowRatio(20241231);

return v;
// 输出：11.1706
```

范例03：指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的可持续增长率(%)

```tsl
// 指定2024年一季报，取格力电器在报告期时的最近1年的会计年度报告期的可持续增长率(%)

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(CT_YearData(), true); // 计算最近会计年度

setsysparam(CT_RecentYear(), 1); // 最近1年

v := SustainableGrowRatio(20240331);

return v;
// 输出：13.3694
```

范例04：取2016年年报格力电器的可持续增长率(%)调整前与调整后

```tsl
// 取2016年年报格力电器的可持续增长率(%)调整前与调整后

// 20180426公布的2017年年报对2016年年报中的归属母公司所有者净利润数据进行了调整

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

RDate := 20161231;

// 调整前：设置指定日早于调整后公布日

setsysparam(pn_date(), 20171231T);

v1 := SustainableGrowRatio(RDate);

// 调整后：设置指定日晚于调整后公布日

setsysparam(pn_date(), 20181231T);

v2 := SustainableGrowRatio(RDate);

return array(v1, v2); // array(8.5264,8.5883)，由于调整前与调整后参与计算的数据有变动，因此结果有差异
```