Files
playbook/docs/tsl/codegen/dotnet/equity/dividend.md
T

30 KiB

股票 / 分红送配

BK_DividendAmountOfEndt(endt)

板块指定日分红总额(除权除息日),与系统参数(pn_bk())相关。

参数 类型 说明
endt datetime 日期。截止日

返回:float

BK_DividendAmountOfEndtQJ(begt, endt)

板块指定区间分红总额(除权除息日),与系统参数(pn_bk())相关。

参数 类型 说明
begt datetime 日期。开始日
endt datetime 日期。截止日

返回:float

BK_DividendAmountOfRdate(rdate)

板块报告期分红总额,与系统参数(pn_bk())相关。

参数 类型 说明
rdate datetime 整数。开始报告期

返回:float

BK_DividendAmountOfRdateQJ(rdate, rdate2, is_special_rdate)

板块报告期区间分红总额,与系统参数(pn_bk())相关。截止日在Rdate与Rdate2之间的分红总额。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。

参数 类型 说明
rdate datetime 整数。开始报告期
rdate2 any 整数。截止报告期
is_special_rdate any 整数。是否考虑特殊分红,非报告期可能会发生分红送股行为,默认为0,不考虑特殊分红

返回:float

stockBonusShareRateOfEndt(endt)

指定日红股比(除权除息日),与系统函数(证券代码)相关。

参数 类型 说明
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockBonusShareRateOfEndt(20240401T);

stockBonusShareRateOfEndtQj(begt, endt)

区间红股比。与系统函数(证券代码)相关。除权除息日在Begt与endt之间的红股比。

参数 类型 说明
begt datetime 日期。开始日
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockBonusShareRateOfEndtQJ(20240101T,20240430T);

stockBonusShareRateOfRdate(rdate)

报告期红股比,与系统函数(证券代码)相关。

参数 类型 说明
rdate int 整数。开始报告期

返回:float

示例

SetSysParam(pn_stock(),"SZ300585");
return StockBonusShareRateOfRdate(20161231);

stockBonusShareRateOfRdateQj(rdate, rdate2, is_special_rdate)

报告期区间红股比,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的红股比。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。

参数 类型 说明
rdate int 整数。开始报告期
rdate2 int 整数。截止报告期
is_special_rdate int 整数。是否考虑特殊分红,非报告期可能会发生分红送股行为,默认为0,不考虑特殊分红

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockBonusShareRateOfRdateQJ(20230101,20231231);

stockBuyandHoldReturn(beg_t, end_t)

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

参数 类型 说明
beg_t datetime 日期类型,开始日期;
end_t datetime 日期类型,截止日期

返回:float

示例

setsysparam(pn_stock(),'SZ000002');
Return StockBuyandHoldReturn(20180827T,20180903T);

stockConversionRateOfEndt(endt)

指定日转增比(除权除息日),与系统函数(证券代码)相关。

参数 类型 说明
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockConversionRateOfEndt(20240401T);

stockConversionRateOfEndtQj(begt, endt)

区间转增比,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的转增比。

参数 类型 说明
begt datetime 日期。开始日
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockConversionRateOfEndtQJ(20240101T,20240430T);

stockConversionRateOfRdate(rdate)

报告期转增比,与系统函数(证券代码)相关。

参数 类型 说明
rdate int 整数。开始报告期

返回:float

示例

SetSysParam(pn_stock(),"SZ300585");
return StockConversionRateOfRdate(20161231);

stockConversionRateOfRdateQj(rdate, rdate2, is_special_rdate)

报告期区间转增比,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的转增比。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。

参数 类型 说明
rdate int 整数。开始报告期
rdate2 int 整数。截止报告期
is_special_rdate int 整数。是否考虑特殊分红,非报告期可能会发生分红送股行为,默认为0,不考虑特殊分红

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockConversionRateOfRdateQJ(20230101,20231231);

stockDistributionInfo(beg_t, end_t)

返回一段时间的配股详情

参数 类型 说明
beg_t datetime 实数,起始日期;
end_t datetime 实数,截止日期;

返回:array

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000759');
v:=StockDistributionInfo(inttodate(20000101),inttodate(20120830));
return v;

stockDistributionInfo2()

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

返回:array

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000759');
setsysparam(pn_date(),20101221T);
v:=StockDistributionInfo2();
return v;

stockDistributionInfo3(r_date, return_type)

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

参数 类型 说明
r_date int 整数,报告期;
return_type int 整数,返回类型;

返回:array

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000759');
v:=StockDistributionInfo3(20081231,0);
return v;

StockDistributionInfo_AdvanceDate(r_date)

报告期配股情况_预案。 配股预案的数据可以从配股表中取得。

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

返回:array

StockDistributionInfo_DecisionDeclareDate(r_date)

报告期配股情况_决案。 配股决案的数据从配股表中取得。

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

返回:array

StockDistributionInfo_ExDate(r_date)

报告期配股情况_实施。 配股实施数据从配股表中取得。

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

返回:array

stockDividendAmountOfEndt(endt)

指定日分红总额(除权除息日),与系统函数(证券代码)相关。

参数 类型 说明
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendAmountOfEndt(20230620T);

stockDividendAmountOfEndtQj(begt, endt)

区间分红总额,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的分红总额。 某次分红总额通过分红送股基数*红利比获得。

参数 类型 说明
begt datetime 日期。开始日
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendAmountOfEndtQJ(20230101T,20231231T);

stockDividendAmountOfRdate(rdate)

报告期分红总额,与系统函数(证券代码)相关。

参数 类型 说明
rdate int 整数。开始报告期

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendAmountOfRdate(20231231);

stockDividendAmountOfRdateQj(rdate, rdate2, is_special_rdate)

报告期区间分红总额,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的分红总额。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。

参数 类型 说明
rdate int 整数。开始报告期
rdate2 int 整数。截止报告期
is_special_rdate int 整数。是否考虑特殊分红,非报告期可能会发生分红送股行为,默认为0,不考虑特殊分红

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendAmountOfRdateQJ(20230101,20231231);

stockDividendRateAfterTaxOfEndt(endt)

指定日实得比(除权除息日),与系统函数(证券代码)相关。

参数 类型 说明
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendRateAfterTaxOfEndt(20230620T);

stockDividendRateAfterTaxOfEndtQj(begt, endt)

区间实得比,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的实得比求和。

参数 类型 说明
begt datetime 日期。开始日
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendRateAfterTaxOfEndtQJ(20230101T,20231231T);

stockDividendRateAfterTaxOfRdate(rdate)

报告期实得比,与系统函数(证券代码)相关。

参数 类型 说明
rdate int 整数。开始报告期

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendRateAfterTaxOfRdate(20231231);

stockDividendRateAfterTaxOfRdateQj(rdate, rdate2, is_special_rdate)

报告期区间实得比,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的实得比求和。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。

参数 类型 说明
rdate int 整数。开始报告期
rdate2 int 整数。截止报告期
is_special_rdate int 整数。是否考虑特殊分红,非报告期可能会发生分红送股行为,默认为0,不考虑特殊分红

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendRateAfterTaxOfRdateQJ(20230101,20231231);

stockDividendRateOfEndt(endt)

指定日红利比(除权除息日),与系统函数(证券代码)相关。

参数 类型 说明
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendRateOfEndt(20230620T);

stockDividendRateOfEndtQj(begt, endt)

区间红利比,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的红利比求和。

参数 类型 说明
begt datetime 日期。开始日
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendRateOfEndtQJ(20230101T,20231231T);

stockDividendRateOfRdate(rdate)

报告期红利比,与系统函数(证券代码)相关。

参数 类型 说明
rdate int 整数。开始报告期

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendRateOfRdate(20231231);

stockDividendRateOfRdateQj(rdate, rdate2, is_special_rdate)

报告期区间分红比,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的红利比求和。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。

参数 类型 说明
rdate int 整数。开始报告期
rdate2 int 整数。截止报告期
is_special_rdate int 整数。是否考虑特殊分红,非报告期可能会发生分红送股行为,默认为0,不考虑特殊分红

返回:float

示例

SetSysParam(pn_stock(),"SH600585");
return StockDividendRateOfRdateQJ(20230101,20231231);

stockDividendYieldRatio(end_t)

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

参数 类型 说明
end_t datetime 日期类型,截止日期;

返回:float

示例

setsysparam(pn_stock(),'SZ000002');
Return StockDividendYieldRatio(20180822T);

stockFhspInfoExt(date_by, beg_t, end_t)

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

参数 类型 说明
date_by datetime 日期类型;取值如下:
beg_t datetime 实数,起始日期;
end_t datetime 实数,截止日期;

返回:array

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockFHSPInfoExt (0,20120101,20120830);
return v;

StockLJFH(beg_t, end_t, v_gqfz)

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

参数 类型 说明
beg_t TDateTime 实数,起始日期;
end_t TDateTime 实数,截止日期;
v_gqfz Boolean 考虑股权分置;

返回:Real,实数,每股累计分红。

StockLJFH_(beg_t, end_t, v_gqfz, return_type)

假设以开始日收盘买入股票,考察累计分红占初始投资的比例(只考虑分红、送股、转增,不考虑配股、增发) (1)如果指定日上市,则假设买入价格为当日收盘价; (2)如果指定日没有上市,则假设买入价格为上市首日的收盘价; (3)ReturnType=0时,取每股区间累计分红/初始投资; ReturnType=1是,取每股区间累计分红。

参数 类型 说明
beg_t datetime 实数,起始日期;
end_t datetime 实数,截止日期;
v_gqfz bool object
return_type any 整数,返回类型;

返回:float

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockLJFH(20020101T,20120830T,true);
return v;

stockLjfhPercent(beg_t, end_t, v_gqfz)

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

参数 类型 说明
beg_t datetime 实数,起始日期;
end_t datetime 实数,截止日期;
v_gqfz bool object

返回:float

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockLJFHPercent(20020101T,20120830T,true);
return v;

stockPfAmount(beg_t, end_t)

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

参数 类型 说明
beg_t datetime 实数,起始日期;
end_t datetime 实数,截止日期;

返回:float

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFAmount(inttodate(20120101),inttodate(20120830));
return v;

stockPfAmount2()

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

返回:float

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
setsysparam(pn_date(),20171231T);
v:=StockPFAmount2();
return v;

stockPfAmountOfRDate(r_date)

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

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

返回:float

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFAmountOfRDate(20111231);
return v;

stockPfAmountOfYear(year)

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

参数 类型 说明
year any 整数,年份;

返回:float

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFAmountOfYear(2011);
return v;

stockPfAndRatioInfo3(r_date, return_type)

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

参数 类型 说明
r_date datetime 报告期类型,报告期;
return_type int 整数,返回类型;

返回:array

示例

setsysparam(pn_stock(),'SZ000002');
Return StockPFAndRatioInfo3(20171231,0);

StockPFAndRatioInfo_ExDate(r_date)

报告期分红送股情况_实施。 分红送股实施数据从分红送股表中取得。

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

返回:array

stockPfInfo(beg_t, end_t)

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

参数 类型 说明
beg_t datetime 实数,起始日期;
end_t datetime 实数,截止日期;

返回:array

示例

{取得SH600005(武钢股份)在20110113与20110913区间分红详情;}
SetSysParam(pn_stock(),'SH600005');
BegT:=inttodate(20110113);
EndT:=inttodate(20110913);
return?StockPFInfo(BegT,EndT);

stockPfInfo2()

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

返回:array

示例

SetSysParam(pn_stock(),'SH600635');
setsysparam(pn_date(),20111202T);
return StockPFInfo2();

stockPfInfo3(r_date, return_type)

报告期分红情况

参数 类型 说明
r_date int 整数,报告期;
return_type int 返回类型;

返回:array

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFInfo3(20111231,0);
return v;

StockPFInfo_AdvanceDate(r_date)

报告期分红情况_预案。 分红情况数据从分红送股表中取得。

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

返回:array

StockPFInfo_DecisionDeclareDate(r_date)

报告期分红情况_决案。 分红情况数据从分红送股表中取得。

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

返回:array

StockPFInfo_ExDate(r_date)

报告期分红情况_实施。 分红情况数据从分红送股表中取得。

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

返回:array

stockPfps(beg_t, end_t)

区间分红(元/股)=Σ每股派现(税前); 每股派现(税前),即分红送股表的红利比;每股派现(税后),即分红送股表的实得比。

参数 类型 说明
beg_t datetime 实数,起始日期;
end_t datetime 实数,截止日期;

返回:float

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFPS (inttodate(20120101),inttodate(20120809));
return v;

stockPfRatio(beg_t, end_t)

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

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

返回:float

示例

SetSysParam(PN_Stock(),'SZ000002');
return StockPFRatio(20200801T,20230801T);

stockPfRatioInfo(beg_t, end_t)

区间送股情况

参数 类型 说明
beg_t datetime 实数,起始日期;
end_t datetime 实数,截止日期;

返回:array

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SZ000002');
v:=StockPFRatioInfo (inttodate(20060101),inttodate(20071231));
return v;

stockPfRatioInfo2()

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

返回:array

示例

oV:=BackUpSystemParameters2();
setsysparam(pn_stock(),'SH600000');
setsysparam(pn_date(),20111202T);
v:=StockPFRatioInfo2();
return v;

StockPFRatioInfo_AdvanceDate(r_date)

报告期送股情况_预案。 送股情况数据从分红送股表中取得。

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

返回:array

StockPFRatioInfo_DecisionDeclareDate(r_date)

报告期送股情况_决案 送股情况数据从分红送股表中取得。

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

返回:array

StockPFRatioInfo_ExDate(r_date)

报告期送股情况_实施。 送股情况数据从分红送股表中取得。

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

返回:array

stockPfRatioOfEndt(endt)

指定日送股比(除权除息日),与系统函数(证券代码)相关。

参数 类型 说明
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockPFRatioOfEndt(20240401T);

stockPfRatioOfEndtQj(begt, endt)

区间送股比,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的送股比。

参数 类型 说明
begt datetime 日期。开始日
endt datetime 日期。截止日

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockPFRatioOfEndtQJ(20240101T,20240430T);

stockPfRatioOfRdate(rdate)

报告期送股比,与系统函数(证券代码)相关。

参数 类型 说明
rdate int 整数。开始报告期

返回:float

示例

SetSysParam(pn_stock(),"SZ300585");
return StockPFRatioOfRdate(20161231);

stockPfRatioOfRdateQj(rdate, rdate2, is_special_rdate)

报告期区间送股比。与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的送股比。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。

参数 类型 说明
rdate int 整数。开始报告期
rdate2 int 整数。截止报告期
is_special_rdate int 整数。是否考虑特殊分红,非报告期可能会发生分红送股行为,默认为0,不考虑特殊分红

返回:float

示例

SetSysParam(pn_stock(),"SZ301052");
return StockPFRatioOfRdateQJ(20230101,20231231);

Stocks_DividendAmountOfEndt(stockarr, endt)

股票列表指定日分红总额。

参数 类型 说明
stockarr array 数组。证券代码列表
endt datetime 日期。截止日

返回:array

Stocks_DividendAmountOfEndtQJ(stockarr, begt, endt)

股票列表区间分红总额。除权除息日在begt与endt之间的分红总额。

参数 类型 说明
stockarr array 数组。证券代码列表
begt datetime 日期。开始日
endt datetime 日期。截止日

返回:array

Stocks_DividendAmountOfRdate(stockarr, rdate)

股票列表指定报告期分红总额。

参数 类型 说明
stockarr array 数组。证券代码列表
rdate datetime 整数。开始报告期

返回:array

Stocks_DividendAmountOfRdateQJ(stockarr, rdate, rdate2, is_special_rdate)

股票列表报告期区间分红总额。截止日在Rdate与Rdate2之间的分红总额。

参数 类型 说明
stockarr array 数组。证券代码列表
rdate datetime 整数。开始报告期
rdate2 any 整数。截止报告期
is_special_rdate any 整数。是否考虑特殊分红,非报告期可能会发生分红送股行为,默认为0,不考虑特殊分红

返回:array

stockPfRatioInfo3(r_date, return_type)

报告期送股情况

参数 类型 说明
r_date Integer 整数,报告期;
return_type Integer 整数,返回类型;

返回:Array

示例

o_v:=BackUpSystemParameters2();
//取'昊华能源'在2011年年报的报告期送股情况;
setSysParam(pn_stock(),'SH601101');
v:=stockPfRatioInfo3(20111231,0);
return v;
//结果: