Files
playbook/skills/tsl-api-reference/references/codegen/dotnet/equity/dividend.md
T
csh e1f7ce052c feat(skills): add tsl api reference skill
Bundle the TSL API index and markdown references under the skill, route TSL docs to use it, and update the codegen index generator to maintain the bundled data.
2026-07-07 16:36:15 +08:00

30 KiB

股票 / 分红送配

bkDividendAmountOfEndt(endt)

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

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

返回:float

bkDividendAmountOfEndtQj(begt, endt)

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

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

返回:float

bkDividendAmountOfRdate(rdate)

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

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

返回:float

bkDividendAmountOfRdateQj(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;

stockDistributionInfoAdvanceDate(r_date)

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

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

返回:array

stockDistributionInfoDecisionDeclareDate(r_date)

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

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

返回:array

stockDistributionInfoExDate(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, 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);

stockPfAndRatioInfoExDate(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;

stockPfInfoAdvanceDate(r_date)

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

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

返回:array

stockPfInfoDecisionDeclareDate(r_date)

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

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

返回:array

stockPfInfoExDate(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;

stockPfRatioInfoAdvanceDate(r_date)

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

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

返回:array

stockPfRatioInfoDecisionDeclareDate(r_date)

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

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

返回:array

stockPfRatioInfoExDate(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);

stocksDividendAmountOfEndt(stockarr, endt)

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

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

返回:array

stocksDividendAmountOfEndtQj(stockarr, begt, endt)

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

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

返回:array

stocksDividendAmountOfRdate(stockarr, rdate)

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

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

返回:array

stocksDividendAmountOfRdateQj(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;
//结果: