FAQ > 金融建模 > 数据提取 > 基本面数据

Q：普通股获利率(股息率)模型算法说明汇总    

  • Q：股息率是上市公司派发的总现金股利与最新总市值的比率，常见算法为分红金额/市值或每股分红/股价。
    在天软中有以下计算模型：
    模型说明算法
    DividendYield(Rdate)指定报告期的普通股获利率(%)
    系统参数：证券代码，时间，CT_TTMData，CT_QuarterData，CT_YearData，CT_RecentYear
    支持范围：A股，B股    		每股股利*报告期总股本/当前日期的总市值*100
    DividendYield6(Rdate,EndT)指定报告期的普通股获利率(%)
    系统参数：证券代码，CT_TTMData，CT_QuarterData，CT_YearData，CT_RecentYear
    支持范围：A股，B股    		每股股利*报告期总股本/EndT日总市值*100
    DividendYield_QJ(rdate,
    rdate2,Endt,IsSpecialRdate)    		区间普通股获利率(%)
    系统参数：证券代码
    支持范围：A股，B股    		rdate至rdate2区间分红总额/EndT日总市值*100
    DividendYield_Year(year,Endt)年度普通股获利率(%)
    系统参数：证券代码
    支持范围：A股，B股    		year年度分红总额/EndT总市值*100
    StockDividendYieldRatio(EndT)最近12个月股息收益率(%)
    系统参数：证券代码
    支持范围：A股，B股    		EndT最近12个月分红金额/EndT日总市值*100
    StocksDividendYield(StockArr,RDate,
    RightType,SType,SampleSelect,EPSCriterion)    		股票列表指定报告期普通股获利率(%)
    系统参数：CT_TTMData，CT_QuarterData，CT_YearData，CT_RecentYear
    支持范围：A股，B股组成的代码序列    		利用成份股加权计算：
    总股本加权：sum(个股每股股利*报告期总股本)/sum(个股报告期总市值)*100
    流通股本加权：sum(个股每股股利*报告期流通股本)/sum(个股报告期流通市值)*100
    算数平均：mean(股票列表报告期普通股获利率(%))
    Bk_DividendYield(ReportDate,
    RightType,SType,SampleSelect,EPSCriterion)    		板块指定报告期普通股获利率(%)
    系统参数：板块，CT_TTMData，CT_QuarterData，CT_YearData，CT_RecentYear
    支持范围：包含A股，B股的板块    		利用成份股加权计算：
    总股本加权：sum(个股每股股利*报告期总股本)/sum(个股报告期总市值)*100
    流通股本加权：sum(个股每股股利*报告期流通股本)/sum(个股报告期流通市值)*100
    算数平均：mean(股票列表报告期普通股获利率(%))
    Index_CallDP(RightType,
    SampleSelect,Criterion,RDateType)    		指数股息率(%)
    系统参数：证券代码，时间
    支持范围：A股，B股指数    		对指数成份股按不同加权方式计算股息率(%)
    Index_dividendyield_DP(Endt)指数过去一年股息率(%)-股息点法
    系统参数：证券代码
    支持范围：部分价格指数：SH000300、SH000905、SH000016、SH000010、SH000852
    		过去1年累计分红/指定日收盘*100
    T 日分红 = T日股息点指数收盘 - T-1日股息点指数收盘
    分红算法详情参考：天软股指期货分红点测算说明
    Index_dividendyield_TR(Endt)过去一年股息率(%)-全收益法1
    系统参数：证券代码
    支持范围：部分价格指数：SH000300、SH000905、SH000016、SH000010、SH000852
    		过去1年累计分红/指定日收盘*100
    T 日分红 = T-1日价格指数收盘 – T日价格指数收盘/(1+T日全收益指数涨幅)
    分红算法详情参考：天软股指期货分红点测算说明
    Index_dividendyield_TR2(Endt)过去一年股息率(%)-全收益法2
    系统参数：证券代码
    支持范围：部分价格指数：SH000300、SH000905、SH000016、SH000010、SH000852
    		过去1年累计分红/指定日收盘*100
    T 日分红 = T-1日价格指数收盘 *（T日全收益指数涨幅 - T日价格指数涨幅）
    分红算法详情参考：天软股指期货分红点测算说明

    使用范例
    范例1：获取个股指定报告期的股息率(%)
    //2024年年报格力电器的普通股获利率(%)
    setsysparam(pn_stock(),'SZ000651');
    setsysparam(pn_date(),20250828t);
    v:=DividendYield(20241231);
    return v;//结果：4.2328

    范例2：获取股票板块指定报告期的股息率(%)
    //返回沪深300 2024年总股本加权的板块普通股获利率
    d:=20250831t;
    Setsysparam(pn_date(),d);
    stkArr:=GetBKByDate("SH000300",d);
    savebk("myhs300","mybk",stkArr);
    SetSysParam(pn_bk(),'myhs300');
    return Bk_DividendYield(20241231,0,0,1,0);
    //结果：2.09

    范例2：获取指数指定报告期的股息率(%)
    //提取2023年7月31日沪深300,全部样本股、整体权重加权、TTM的股息率
    setsysparam(pn_stock(),'SH000300');
    setsysparam(pn_date(),20230731T);
    return Index_CallDP(11,0,0,0);
    //结果：2.9942