feat(tsl-api-reference): index class and unit APIs

Migrate reference pages to declaration-line storage and rebuild the
13-column index.

Add qualified member lookup plus regression and end-to-end coverage.
This commit is contained in:
csh
2026-07-29 15:47:46 +08:00
parent 9edc8fc868
commit 13be5ea0aa
239 changed files with 39157 additions and 12846 deletions
@@ -2,6 +2,8 @@
## `BK_DividendAmountOfEndt(endt)`
声明:function
板块指定日分红总额(除权除息日),与系统参数(pn_bk())相关。
| 参数 | 类型 | 说明 |
@@ -12,6 +14,8 @@
## `BK_DividendAmountOfEndtQJ(begt, endt)`
声明:function
板块指定区间分红总额(除权除息日),与系统参数(pn_bk())相关。
| 参数 | 类型 | 说明 |
@@ -23,6 +27,8 @@
## `BK_DividendAmountOfRdate(rdate)`
声明:function
板块报告期分红总额,与系统参数(pn_bk())相关。
| 参数 | 类型 | 说明 |
@@ -33,6 +39,8 @@
## `BK_DividendAmountOfRdateQJ(rdate, rdate2, is_special_rdate)`
声明:function
板块报告期区间分红总额,与系统参数(pn_bk())相关。截止日在Rdate与Rdate2之间的分红总额。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。
| 参数 | 类型 | 说明 |
@@ -45,6 +53,8 @@
## `stockBonusShareRateOfEndt(endt)`
声明:function
指定日红股比(除权除息日),与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -62,6 +72,8 @@ return StockBonusShareRateOfEndt(20240401T);
## `stockBonusShareRateOfEndtQj(begt, endt)`
声明:function
区间红股比。与系统函数(证券代码)相关。除权除息日在Begt与endt之间的红股比。
| 参数 | 类型 | 说明 |
@@ -80,6 +92,8 @@ return StockBonusShareRateOfEndtQJ(20240101T,20240430T);
## `stockBonusShareRateOfRdate(rdate)`
声明:function
报告期红股比,与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -97,6 +111,8 @@ return StockBonusShareRateOfRdate(20161231);
## `stockBonusShareRateOfRdateQj(rdate, rdate2, is_special_rdate)`
声明:function
报告期区间红股比,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的红股比。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。
| 参数 | 类型 | 说明 |
@@ -116,6 +132,8 @@ return StockBonusShareRateOfRdateQJ(20230101,20231231);
## `stockBuyandHoldReturn(beg_t, end_t)`
声明:function
提取股票的持仓不动收益率(%),与系统股票pn_stock()、当前时间pn_date()、周期pn_cycle(),除权方式pn_rate()相关。
| 参数 | 类型 | 说明 |
@@ -134,6 +152,8 @@ Return StockBuyandHoldReturn(20180827T,20180903T);
## `stockConversionRateOfEndt(endt)`
声明:function
指定日转增比(除权除息日),与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -151,6 +171,8 @@ return StockConversionRateOfEndt(20240401T);
## `stockConversionRateOfEndtQj(begt, endt)`
声明:function
区间转增比,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的转增比。
| 参数 | 类型 | 说明 |
@@ -169,6 +191,8 @@ return StockConversionRateOfEndtQJ(20240101T,20240430T);
## `stockConversionRateOfRdate(rdate)`
声明:function
报告期转增比,与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -186,6 +210,8 @@ return StockConversionRateOfRdate(20161231);
## `stockConversionRateOfRdateQj(rdate, rdate2, is_special_rdate)`
声明:function
报告期区间转增比,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的转增比。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。
| 参数 | 类型 | 说明 |
@@ -205,6 +231,8 @@ return StockConversionRateOfRdateQJ(20230101,20231231);
## `stockDistributionInfo(beg_t, end_t)`
声明:function
返回一段时间的配股详情
| 参数 | 类型 | 说明 |
@@ -225,6 +253,8 @@ return v;
## `stockDistributionInfo2()`
声明:function
上市以来截止当前时间(与除权日比较)的配股详情,与当前股票、当前时间相关。
返回:array
@@ -241,6 +271,8 @@ return v;
## `stockDistributionInfo3(r_date, return_type)`
声明:function
返回指定报告期的配股情况
| 参数 | 类型 | 说明 |
@@ -261,6 +293,8 @@ return v;
## `StockDistributionInfo_AdvanceDate(r_date)`
声明:function
报告期配股情况\_预案。 配股预案的数据可以从配股表中取得。
| 参数 | 类型 | 说明 |
@@ -271,6 +305,8 @@ return v;
## `StockDistributionInfo_DecisionDeclareDate(r_date)`
声明:function
报告期配股情况\_决案。 配股决案的数据从配股表中取得。
| 参数 | 类型 | 说明 |
@@ -281,6 +317,8 @@ return v;
## `StockDistributionInfo_ExDate(r_date)`
声明:function
报告期配股情况\_实施。 配股实施数据从配股表中取得。
| 参数 | 类型 | 说明 |
@@ -291,6 +329,8 @@ return v;
## `stockDividendAmountOfEndt(endt)`
声明:function
指定日分红总额(除权除息日),与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -308,6 +348,8 @@ return StockDividendAmountOfEndt(20230620T);
## `stockDividendAmountOfEndtQj(begt, endt)`
声明:function
区间分红总额,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的分红总额。 某次分红总额通过分红送股基数\*红利比获得。
| 参数 | 类型 | 说明 |
@@ -326,6 +368,8 @@ return StockDividendAmountOfEndtQJ(20230101T,20231231T);
## `stockDividendAmountOfRdate(rdate)`
声明:function
报告期分红总额,与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -343,6 +387,8 @@ return StockDividendAmountOfRdate(20231231);
## `stockDividendAmountOfRdateQj(rdate, rdate2, is_special_rdate)`
声明:function
报告期区间分红总额,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的分红总额。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。
| 参数 | 类型 | 说明 |
@@ -362,6 +408,8 @@ return StockDividendAmountOfRdateQJ(20230101,20231231);
## `stockDividendRateAfterTaxOfEndt(endt)`
声明:function
指定日实得比(除权除息日),与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -379,6 +427,8 @@ return StockDividendRateAfterTaxOfEndt(20230620T);
## `stockDividendRateAfterTaxOfEndtQj(begt, endt)`
声明:function
区间实得比,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的实得比求和。
| 参数 | 类型 | 说明 |
@@ -397,6 +447,8 @@ return StockDividendRateAfterTaxOfEndtQJ(20230101T,20231231T);
## `stockDividendRateAfterTaxOfRdate(rdate)`
声明:function
报告期实得比,与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -414,6 +466,8 @@ return StockDividendRateAfterTaxOfRdate(20231231);
## `stockDividendRateAfterTaxOfRdateQj(rdate, rdate2, is_special_rdate)`
声明:function
报告期区间实得比,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的实得比求和。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。
| 参数 | 类型 | 说明 |
@@ -433,6 +487,8 @@ return StockDividendRateAfterTaxOfRdateQJ(20230101,20231231);
## `stockDividendRateOfEndt(endt)`
声明:function
指定日红利比(除权除息日),与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -450,6 +506,8 @@ return StockDividendRateOfEndt(20230620T);
## `stockDividendRateOfEndtQj(begt, endt)`
声明:function
区间红利比,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的红利比求和。
| 参数 | 类型 | 说明 |
@@ -468,6 +526,8 @@ return StockDividendRateOfEndtQJ(20230101T,20231231T);
## `stockDividendRateOfRdate(rdate)`
声明:function
报告期红利比,与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -485,6 +545,8 @@ return StockDividendRateOfRdate(20231231);
## `stockDividendRateOfRdateQj(rdate, rdate2, is_special_rdate)`
声明:function
报告期区间分红比,与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的红利比求和。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。
| 参数 | 类型 | 说明 |
@@ -504,6 +566,8 @@ return StockDividendRateOfRdateQJ(20230101,20231231);
## `stockDividendYieldRatio(end_t)`
声明:function
提取股票的指定日股息收益率(%)(最近12个月,按除息日),与系统股票pn_stock()、当前时间pn_date()相关。
| 参数 | 类型 | 说明 |
@@ -521,6 +585,8 @@ Return StockDividendYieldRatio(20180822T);
## `stockFhspInfoExt(date_by, beg_t, end_t)`
声明:function
区间分红送股详情。 统计当前股票从开始日期到截止日期之间的分红送股数据。该数据从分红送股表中取得。
| 参数 | 类型 | 说明 |
@@ -542,6 +608,8 @@ return v;
## `StockLJFH(beg_t, end_t, v_gqfz)`
声明:function
统计从开始日期到截止日期的每股累计分红(只考虑分红、送股、转增,不考虑配股、增发)。
| 参数 | 类型 | 说明 |
@@ -554,6 +622,8 @@ return v;
## `StockLJFH_(beg_t, end_t, v_gqfz, return_type)`
声明:function
假设以开始日收盘买入股票,考察累计分红占初始投资的比例(只考虑分红、送股、转增,不考虑配股、增发) (1)如果指定日上市,则假设买入价格为当日收盘价; (2)如果指定日没有上市,则假设买入价格为上市首日的收盘价; (3)ReturnType=0时,取每股区间累计分红/初始投资; ReturnType=1是,取每股区间累计分红。
| 参数 | 类型 | 说明 |
@@ -576,6 +646,8 @@ return v;
## `stockLjfhPercent(beg_t, end_t, v_gqfz)`
声明:function
假设以开始日收盘买入股票,考察每股累计分红占初始投资的比例(只考虑分红、送股、转增,不考虑配股、增发)。 (1)如果指定日上市,则假设买入价格为当日收盘价,即初始投资; (2)如果指定日没有上市,则假设买入价格为上市首日的收盘价,即初始投资。
| 参数 | 类型 | 说明 |
@@ -597,6 +669,8 @@ return v;
## `stockPfAmount(beg_t, end_t)`
声明:function
区间分红总额(万),统计起始日期到截止日期之间的分红总额。某次分红总额通过除权除息日的总股本\*红利比获得。
| 参数 | 类型 | 说明 |
@@ -617,6 +691,8 @@ return v;
## `stockPfAmount2()`
声明:function
统计上市至系统当前时间(默认今天)的分红总额,单位万。某次分红总额通过除权除息日的总股本\*红利比获得。 系统参数:pn_stock()、pn_date()
返回:float
@@ -633,6 +709,8 @@ return v;
## `stockPfAmountOfRDate(r_date)`
声明:function
报告期分红总额(万)=每股股利\*总股本/10000。 每股股利,即分红送股表的红利比。总股本即指定报告期的总股本。
| 参数 | 类型 | 说明 |
@@ -652,6 +730,8 @@ return v;
## `stockPfAmountOfYear(year)`
声明:function
年度分红总额(万)=∑(每股股利\*总股本)/10000
| 参数 | 类型 | 说明 |
@@ -671,6 +751,8 @@ return v;
## `stockPfAndRatioInfo3(r_date, return_type)`
声明:function
提取股票的指定报告期的报告期分红送股情况,与系统股票pn_stock()、当前时间pn_date()相关。
| 参数 | 类型 | 说明 |
@@ -689,6 +771,8 @@ Return StockPFAndRatioInfo3(20171231,0);
## `StockPFAndRatioInfo_ExDate(r_date)`
声明:function
报告期分红送股情况\_实施。 分红送股实施数据从分红送股表中取得。
| 参数 | 类型 | 说明 |
@@ -699,6 +783,8 @@ Return StockPFAndRatioInfo3(20171231,0);
## `stockPfInfo(beg_t, end_t)`
声明:function
返回指定股票区间分红详情,该函数和证券代码有关。
| 参数 | 类型 | 说明 |
@@ -720,6 +806,8 @@ return?StockPFInfo(BegT,EndT);
## `stockPfInfo2()`
声明:function
返回指定股票上市以来截止当前时间(除权除息日)的分红情况,该函数和证券代码、当前时间有关。
返回:array
@@ -734,6 +822,8 @@ return StockPFInfo2();
## `stockPfInfo3(r_date, return_type)`
声明:function
报告期分红情况
| 参数 | 类型 | 说明 |
@@ -754,6 +844,8 @@ return v;
## `StockPFInfo_AdvanceDate(r_date)`
声明:function
报告期分红情况\_预案。 分红情况数据从分红送股表中取得。
| 参数 | 类型 | 说明 |
@@ -764,6 +856,8 @@ return v;
## `StockPFInfo_DecisionDeclareDate(r_date)`
声明:function
报告期分红情况\_决案。 分红情况数据从分红送股表中取得。
| 参数 | 类型 | 说明 |
@@ -774,6 +868,8 @@ return v;
## `StockPFInfo_ExDate(r_date)`
声明:function
报告期分红情况\_实施。 分红情况数据从分红送股表中取得。
| 参数 | 类型 | 说明 |
@@ -784,6 +880,8 @@ return v;
## `stockPfps(beg_t, end_t)`
声明:function
区间分红(元/股)=Σ每股派现(税前); 每股派现(税前),即分红送股表的红利比;每股派现(税后),即分红送股表的实得比。
| 参数 | 类型 | 说明 |
@@ -804,6 +902,8 @@ return v;
## `stockPfRatio(beg_t, end_t)`
声明:function
获取当前证券区间送股比,与系统参数(股票)相关。允许通过系统时间设置EndT(函数EndT不设置)。
| 参数 | 类型 | 说明 |
@@ -822,6 +922,8 @@ return StockPFRatio(20200801T,20230801T);
## `stockPfRatioInfo(beg_t, end_t)`
声明:function
区间送股情况
| 参数 | 类型 | 说明 |
@@ -842,6 +944,8 @@ return v;
## `stockPfRatioInfo2()`
声明:function
上市以来截止到当前时间(按除权日)的送股情况,与当前证券、当前时间相关。
返回:array
@@ -858,6 +962,8 @@ return v;
## `StockPFRatioInfo_AdvanceDate(r_date)`
声明:function
报告期送股情况\_预案。 送股情况数据从分红送股表中取得。
| 参数 | 类型 | 说明 |
@@ -868,6 +974,8 @@ return v;
## `StockPFRatioInfo_DecisionDeclareDate(r_date)`
声明:function
报告期送股情况\_决案 送股情况数据从分红送股表中取得。
| 参数 | 类型 | 说明 |
@@ -878,6 +986,8 @@ return v;
## `StockPFRatioInfo_ExDate(r_date)`
声明:function
报告期送股情况\_实施。 送股情况数据从分红送股表中取得。
| 参数 | 类型 | 说明 |
@@ -888,6 +998,8 @@ return v;
## `stockPfRatioOfEndt(endt)`
声明:function
指定日送股比(除权除息日),与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -905,6 +1017,8 @@ return StockPFRatioOfEndt(20240401T);
## `stockPfRatioOfEndtQj(begt, endt)`
声明:function
区间送股比,与系统函数(证券代码)相关。除权除息日在Begt与endt之间的送股比。
| 参数 | 类型 | 说明 |
@@ -923,6 +1037,8 @@ return StockPFRatioOfEndtQJ(20240101T,20240430T);
## `stockPfRatioOfRdate(rdate)`
声明:function
报告期送股比,与系统函数(证券代码)相关。
| 参数 | 类型 | 说明 |
@@ -940,6 +1056,8 @@ return StockPFRatioOfRdate(20161231);
## `stockPfRatioOfRdateQj(rdate, rdate2, is_special_rdate)`
声明:function
报告期区间送股比。与系统函数(证券代码)相关。截止日在Rdate与Rdate2之间的送股比。若取整年数据如2023年,可将开始报告期设置20230101,截止报告期20231231。
| 参数 | 类型 | 说明 |
@@ -959,6 +1077,8 @@ return StockPFRatioOfRdateQJ(20230101,20231231);
## `Stocks_DividendAmountOfEndt(stockarr, endt)`
声明:function
股票列表指定日分红总额。
| 参数 | 类型 | 说明 |
@@ -970,6 +1090,8 @@ return StockPFRatioOfRdateQJ(20230101,20231231);
## `Stocks_DividendAmountOfEndtQJ(stockarr, begt, endt)`
声明:function
股票列表区间分红总额。除权除息日在begt与endt之间的分红总额。
| 参数 | 类型 | 说明 |
@@ -982,6 +1104,8 @@ return StockPFRatioOfRdateQJ(20230101,20231231);
## `Stocks_DividendAmountOfRdate(stockarr, rdate)`
声明:function
股票列表指定报告期分红总额。
| 参数 | 类型 | 说明 |
@@ -993,6 +1117,8 @@ return StockPFRatioOfRdateQJ(20230101,20231231);
## `Stocks_DividendAmountOfRdateQJ(stockarr, rdate, rdate2, is_special_rdate)`
声明:function
股票列表报告期区间分红总额。截止日在Rdate与Rdate2之间的分红总额。
| 参数 | 类型 | 说明 |
@@ -1006,6 +1132,8 @@ return StockPFRatioOfRdateQJ(20230101,20231231);
## `stockPfRatioInfo3(r_date, return_type)`
声明:function
报告期送股情况
| 参数 | 类型 | 说明 |