Files
playbook/skills/tsl-api-reference/references/codegen/dotnet/financial/financial_analysis-investment_income.md
T

14 KiB

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

dividendYield(r_date)

声明:function

返回普通股获利率(%)

参数 类型 说明
r_date integer 整数,报告期

返回:real

示例

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

setsysparam(pn_date(), 20250828t);

v := DividendYield(20241231);

return v;
// 输出:4.2328

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

// 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年的会计年度报告期的普通股获利率(%)

// 指定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

返回股息支付率(%)

参数 类型 说明
report_date integer 整数,报告期

返回:real

示例

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := DividendYield3(20241231);

return v;
// 输出:34.808

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

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

v := DividendYield3(20241231);

return v;
// 输出:52.3052

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

// 指定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年年报格力电器的股息支付率(%)调整前与调整后

// 取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

返回股利保障倍数

参数 类型 说明
report_date integer 整数,报告期

返回:real

示例

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := DividendYield4(20241231);

return v;
// 输出:2.8729

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

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

v := DividendYield4(20241231);

return v;
// 输出:1.9119

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

// 指定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年年报格力电器的股利保障倍数调整前与调整后

// 取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

返回留存盈利比率(%)

参数 类型 说明
report_date integer 整数,报告期

返回:real

示例

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := DividendYield5(20241231);

return v;
// 输出:65.192

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

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

v := DividendYield5(20241231);

return v;
// 输出:47.6948

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

// 指定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年年报格力电器的留存盈利比率(%)调整前与调整后

// 取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

返回普通股获利率(%)

参数 类型 说明
report_date integer 整数,报告期;
end_t date 日期型,计算获利日期

返回:real

示例

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := DividendYield6(20241231, 20250828t);

return v;
// 输出:4.2328

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

// 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年的会计年度报告期的普通股获利率(%)

// 指定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

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

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

返回:float

示例

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

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

setsysparam(pn_stock(), 'SZ000002');

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

investIncomeRatio(r_date)

声明:function

计算投资收益率(%),公式为投资收益/(长期投资合计+短期投资+长期投资合计+短期投资)/2 *100

参数 类型 说明
r_date integer 整数,报告期

返回:real

示例

范例01:调用函数

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

netAssetAdjust(r_date)

声明:function

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

参数 类型 说明
r_date integer 整数,报告期

返回:real

示例

范例01:调用函数

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

netAssetRatio(report_date)

声明:function

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

参数 类型 说明
report_date integer 整数,报告期

返回:real

示例

范例01:调用函数

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

sustainableGrowRatio(r_date)

声明:function

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

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

返回:real

示例

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

v := SustainableGrowRatio(20241231);

return v;
// 输出:15.2687

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

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

oV := BackUpSystemParameters2();

setsysparam(pn_stock(), 'SZ000651');

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

v := SustainableGrowRatio(20241231);

return v;
// 输出:11.1706

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

// 指定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年年报格力电器的可持续增长率(%)调整前与调整后

// 取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),由于调整前与调整后参与计算的数据有变动,因此结果有差异