天软金融分析.NET函数大全 > 金融函数 > 财务分析 > 投资收益

DividendYield    

简述
普通股获利率(%)
普通股获利率又常称股息实得利率,可用于衡量企业的股息收益,反映普通股股东当期股息收益率。
1、支持报告期、TTM、最近会计年度的提取,不支持单季度的提取,用法如下,
在调用模型之前,通过设置系统参数指定对应算法:
1)不设置时,默认提取指定报告期RDate的数据,见【范例1】
2)设置SetSysParam(CT_TTMData(),True),表示获取TTM数据,见【范例2】
3)设置SetSysParam(CT_YearData(),True)与setsysparam(CT_RecentYear(),N)表示获取最近N个会计年度数据,见【范例3】
4)设置SetSysParam(CT_QuarterData(),True),表示获取单季度的数据,不支持,结果返回0
5)当同时设置多个参数时,按优先级从高到低:TTM>单季度>最近N个会计年度

2、股本取数模式仅考虑变动日

3、股价为不复权的价格
定义
DividendYield(RDate:Integer):Real
参数
名称类型说明
RDateInteger整数,报告期。
返回Real实数,普通股获利率(%)。
  • 算法
    普通股获利率(%)=每股股利/当前日期的收盘价*100=每股股利*报告期总股本/当前日期的总市值*100
    其中,
    每股股利来源【股票.分红送股表】中‘红利比’字段,在不同算法中处理如下:
    分类 指标算法
    报告期 指定报告期的红利比
    TTM 最近四个季度报告期的红利比*当期总股本/ 指定报告期总股本
    最近会计年度 截止报告期最近年度报告期的红利比
    单季度 指定报告期单季度的每股股利为0

    报告期总股本为报告期当日的总股本
    当前日期的总市值=当前日期的总股本*当前日期的收盘价(不复权)
    范例

    范例01:报告期指标提取
    //2024年年报格力电器的普通股获利率(%)
    oV:=BackUpSystemParameters2();
    setsysparam(pn_stock(),'SZ000651');
    setsysparam(pn_date(),20250828t);
    v:=DividendYield(20241231);
    return v;//结果:4.2328

    范例02: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年的会计年度报告期的普通股获利率(%)
    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
    参考
    DividendPerShar StockClose 
相关