csh/playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files
skills/tsl-api-reference/references/codegen/dotnet/equity/share_structure.md
+114
View File
@@ -2,6 +2,8 @@
## `getNShares(info_id, end_t, value_field_name, changed_field_name, declared_date_field)`
声明：function
指定日股本，与系统参数(股票)相关。
| 参数 | 类型 | 说明 |
@@ -23,6 +25,8 @@ return GetNShares(16,20230801T,"总股本","变动日","公告日");
## `mergeReformListDate()`
声明：function
提取股票的股权分置后交易首日，与系统股票pn_stock()、当前时间pn_date()相关。
返回：float
@@ -36,6 +40,8 @@ Return MergeReformListDate();
## `nSharesOfA(info_id, end_t)`
声明：function
A股流通股本，与系统参数(股票)相关。
| 参数 | 类型 | 说明 |
@@ -54,6 +60,8 @@ return NSharesOfA(16,20230801T);
## `nSharesOfB(info_id, end_t)`
声明：function
B股流通股本，与系统参数(股票)相关。
| 参数 | 类型 | 说明 |
@@ -72,6 +80,8 @@ return NSharesOfB(16,20230801T);
## `stockanshares(endt)`
声明：function
股票A股总量，单位：（股）。与系统参数(证券代码)，系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的） A股=总股本-B股-H股-其中：有限售外资股-外资法人股
| 参数 | 类型 | 说明 |
@@ -89,6 +99,8 @@ return StockANShares(20200924T); //结果：9724196533
## `stockBnShares(end_t)`
声明：function
B股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回B股股本数。 与系统参数（证券代码），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -109,6 +121,8 @@ return v;
## `stockBTotalShares(end_t)`
声明：function
B股总股本，单位：（股），与系统参数(证券代码)相关。 与系统参数(证券代码)，系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -126,6 +140,8 @@ return StockBTotalShares(20241224T);
## `stockCpShares(end_t)`
声明：function
转配股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回转配股。
| 参数 | 类型 | 说明 |
@@ -145,6 +161,8 @@ return v;
## `stockDsShares(end_t)`
声明：function
境内法人股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回境内法人股。
| 参数 | 类型 | 说明 |
@@ -164,6 +182,8 @@ return v;
## `stockFlShares(end_t)`
声明：function
外资发起人股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回外资发起人股。
| 参数 | 类型 | 说明 |
@@ -183,6 +203,8 @@ return v;
## `stockFnShares(end_t)`
声明：function
有限售外资股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回有限售外资股。 与系统参数（证券代码）,系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -202,6 +224,8 @@ return v;
## `stockFreeNegotiableShares(endt)`
声明：function
自由流通股本，与系统参数（证券代码）相关
| 参数 | 类型 | 说明 |
@@ -219,6 +243,8 @@ return StockFreeNegotiableShares(20211118T);
## `stockFreeNegotiableShares3()`
声明：function
最新自由流通股本，与系统参数（证券代码,日期）相关
返回：float
@@ -233,6 +259,8 @@ return StockFreeNegotiableShares3();
## `stockFreeNegotiableSharesAdjust(endt)`
声明：function
自由流通股本(调整后)，与系统参数（证券代码）相关
| 参数 | 类型 | 说明 |
@@ -250,6 +278,8 @@ return StockFreeNegotiableSharesAdjust(20211118T);
## `stockFreeNegotiableSharesAdjust3()`
声明：function
最新自由流通股本(调整后)，与系统参数（证券代码,日期）相关
返回：float
@@ -264,6 +294,8 @@ return StockFreeNegotiableSharesAdjust3();
## `stockFreeNegotiableSharesAdjustNPercent(endt)`
声明：function
自由流通股占流通股本(%)(调整后)，与系统参数（证券代码）相关
| 参数 | 类型 | 说明 |
@@ -281,6 +313,8 @@ return StockFreeNegotiableSharesAdjustNPercent(20211118T);
## `stockFreeNegotiableSharesAdjustNPercent3()`
声明：function
最新自由流通股占流通股本(%)(调整后)，与系统参数（证券代码,日期）相关
返回：float
@@ -295,6 +329,8 @@ return StockFreeNegotiableSharesAdjustNPercent3();
## `stockFreeNegotiableSharesAdjustPercent(endt)`
声明：function
自由流通股占总股本(%)(调整后)，与系统参数（证券代码）相关
| 参数 | 类型 | 说明 |
@@ -312,6 +348,8 @@ return StockFreeNegotiableSharesAdjustPercent(20211118T);
## `stockFreeNegotiableSharesAdjustPercent3()`
声明：function
最新自由流通股占总股本(%)(调整后)，与系统参数（证券代码,日期）相关
返回：float
@@ -326,6 +364,8 @@ return StockFreeNegotiableSharesAdjustPercent3();
## `stockFreeNegotiableSharesNPercent(endt)`
声明：function
自由流通股占流通股本(%)，与系统参数（证券代码）相关
| 参数 | 类型 | 说明 |
@@ -343,6 +383,8 @@ return StockFreeNegotiableSharesNPercent(20211118T);
## `stockFreeNegotiableSharesNPercent3()`
声明：function
最新自由流通股占流通股本(%)，与系统参数（证券代码,日期）相关
返回：float
@@ -357,6 +399,8 @@ return StockFreeNegotiableSharesNPercent3();
## `stockFreeNegotiableSharesPercent(endt)`
声明：function
自由流通股占总股本(%)，与系统参数（证券代码）相关
| 参数 | 类型 | 说明 |
@@ -374,6 +418,8 @@ return StockFreeNegotiableSharesPercent(20211118T);
## `stockFreeNegotiableSharesPercent3()`
声明：function
最新自由流通股占总股本(%)，与系统参数（证券代码,日期）相关
返回：float
@@ -388,6 +434,8 @@ return StockFreeNegotiableSharesPercent3();
## `stockHasNaShares(end_t)`
声明：function
已上市流通A股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回已上市流通A股。 与系统参数（证券代码），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -407,6 +455,8 @@ return v;
## `stockHnShares(end_t)`
声明：function
H股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回H股。 与系统参数（证券代码），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -426,6 +476,8 @@ return v;
## `stockHTotalShares(end_t)`
声明：function
H股总股本，单位：（股），与系统参数(证券代码)，系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -443,6 +495,8 @@ return StockHTotalShares(20241224T);
## `stockNegotiableShares(end_t)`
声明：function
流通股本。 如果是A股，则返回已上市流通A股；如果是B股票，则返回流通B股。 与系统参数（证券代码），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -462,6 +516,8 @@ return v;
## `stockNegotiableShares3()`
声明：function
最新流通股本。 函数默认截止日为今天，如果在调用该函数之前，设置当前日期，则返回设置的日期的流通股本数据。 与系统参数（证券代码、时间），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
返回：float
@@ -478,12 +534,16 @@ return v;
## `stockNegotiableSharesBeforeReform()`
声明：function
返回指定股票的股权分置前流通股本，单位：（股），该函数与证券代码有关。Real。 特别说明：数据下架，本模型已废弃
返回：float
## `stockNnShares(end_t)`
声明：function
未流通股，单位：（股）。 （1）未流通股＝发起人股＋募集法人股＋自然人法人股＋内部职工股＋优先股＋转配股＋其他未流通股； （2）从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，可以取出最近的发起人股、募集法人股等股本数据，根据算法计算出未流通股。
| 参数 | 类型 | 说明 |
@@ -503,6 +563,8 @@ return v;
## `stockNnShares2(end_t)`
声明：function
有限售条件的流通股，单位：（股）。 （1）有限售条件的流通股=总股本－已上市流通A股－B股－H股； （2）从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，可以取出最近的总股本、已上市流通A股等股本数据，根据算法计算出有限售条件的流通股。 与系统参数（证券代码），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -522,12 +584,16 @@ return v;
## `stockNnSharesBeforeReform()`
声明：function
返回指定股票的股权分置前非流通股，单位：（股），该函数与证券代码有关。Real。 特别说明：数据下架，本模型已废弃
返回：float
## `stockNpShares(end_t)`
声明：function
自然人法人股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回自然人法人股。
| 参数 | 类型 | 说明 |
@@ -547,6 +613,8 @@ return v;
## `stockNShares(end_t)`
声明：function
流通股(A.B.H)，单位：（股）。 （1）流通股(A.B.H)＝流通A股＋B股＋H股； （2）从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，可以取出最近的流通A股、B股、H股等股本数据，根据算法计算出流通股(A.B.H)。 与系统参数（证券代码），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -566,6 +634,8 @@ return v;
## `stockOnShares(end_t)`
声明：function
其它股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回其它股。
| 参数 | 类型 | 说明 |
@@ -585,6 +655,8 @@ return v;
## `stockPpShares(end_t)`
声明：function
募集法人股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回募集法人股。
| 参数 | 类型 | 说明 |
@@ -604,6 +676,8 @@ return v;
## `stockPriorShares(end_t)`
声明：function
优先股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回优先股。
| 参数 | 类型 | 说明 |
@@ -623,6 +697,8 @@ return v;
## `stockRdShares(end_t)`
声明：function
有限售其他内资股，与系统参数(证券代码)相关 系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的） 有限售其他内资股=有限售境内法人股+有限售境内自然人股
| 参数 | 类型 | 说明 |
@@ -640,6 +716,8 @@ return StockRDShares(20200924T); //结果：9881598
## `stockRfShares(end_t)`
声明：function
有限售外资股，与系统参数(证券代码)相关 系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的） 有限售外资股=有限售境外法人股+有限售境外自然人持股
| 参数 | 类型 | 说明 |
@@ -657,6 +735,8 @@ return StockRFShares(20250924T); //结果：2648616
## `stockRShares(end_t)`
声明：function
有限售股份，与系统参数(证券代码)相关 系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -674,6 +754,8 @@ return StockRShares(20200924T); //结果：9881598
## `stockShare(end_t)`
声明：function
股本结构。 从股本结构表中取出截止至EndT的股本结构表数据。
| 参数 | 类型 | 说明 |
@@ -693,6 +775,8 @@ return v;
## `stockShares(end_t, return_field)`
声明：function
股本数量，单位（股）。
| 参数 | 类型 | 说明 |
@@ -713,6 +797,8 @@ return v;
## `stockShares3(return_field)`
声明：function
最新股本数量，与系统参数（证券代码\时间）相关 系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -733,6 +819,8 @@ return v;
## `stockSharesRatio(end_t, share_name1, share_name2)`
声明：function
股本比(%)。 （1）股本比(%)=ShareName1的股本/ShareName2的股本\*100； （2）函数从股本结构表中取出EndT的ShareName1和ShareName2两个股本数据，根据算法可以计算出股本比(%)。
| 参数 | 类型 | 说明 |
@@ -755,6 +843,8 @@ return v;
## `stockSoShares(end_t)`
声明：function
国家股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回国家股。
| 参数 | 类型 | 说明 |
@@ -774,6 +864,8 @@ return v;
## `stockSShares(end_t)`
声明：function
发起人股，单位：（股）。 （1）发起人股＝国家股+境内法人股+外资法人股+其他法人股； （2）从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，可以取出最近的国家股、境内法人股等股本数据，根据算法计算出发起人股。
| 参数 | 类型 | 说明 |
@@ -793,6 +885,8 @@ return v;
## `stockStuffShares(end_t)`
声明：function
内部职工股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回内部职工股。
| 参数 | 类型 | 说明 |
@@ -812,6 +906,8 @@ return v;
## `stockTlShares(end_t)`
声明：function
高管股，单位：（股）。 从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回高管股。
| 参数 | 类型 | 说明 |
@@ -831,6 +927,8 @@ return v;
## `stockTotalShares(end_t)`
声明：function
总股本，单位：（股）。 与系统参数（证券代码），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的） （1）总股本＝未流通股＋流通股； （2）从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，可以取出最近的未流通股、流通股等股本数据，根据算法计算出总股本。
| 参数 | 类型 | 说明 |
@@ -850,6 +948,8 @@ return v;
## `stockTotalShares3()`
声明：function
最新总股本 函数默认截止日为今天，如果在调用该函数之前，设置当前日期，则返回设置的日期的总股本。 与系统参数（证券代码，时间），系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
返回：float
@@ -866,6 +966,8 @@ return v;
## `stockTotalSharesBeforeIssue()`
声明：function
总股本（发行前）。
返回：float
@@ -881,6 +983,8 @@ return v;
## `stockTotalSharesForPs(end_t)`
声明：function
总股本（计算每股指标用），单位：（股）。 （1）从股本结构表中，取出小于变动日小于EndT且最接近EndT的记录，返回高管股； （2）如果EndT未上市，则取上市前的总股本（发行后总股本-发行额度）。如果上市首日没有数据，则取变动表中的第一条记录。
| 参数 | 类型 | 说明 |
@@ -900,6 +1004,8 @@ return v;
## `stockTotalSharesRight(end_t)`
声明：function
总股本（加权），单位：（股）。 （1）加权的总股本=加权的债转股+加权新股+加权增发； （2）根据EndT得到期初报告期RDate； （3）加权债转股=RDate至EndT之前的债转股总和/RDate至EndT之前的月份； 加权增发=RDate至EndT之前的增发股总和/RDate至EndT之前的月份； 加权新股=RDate至EndT之前的增发股总和/RDate至EndT之前的天数；
| 参数 | 类型 | 说明 |
@@ -919,6 +1025,8 @@ return v;
## `stockUnShares(end_t)`
声明：function
无限售条件股份，与系统参数(证券代码)相关 系统参数PN_ChangedDateMode()相关，默认PN_ChangedDateMode()=0，同时考虑变动日和公布日，PN_ChangedDateMode()=1，表示只考虑变动日的情况（以前的）
| 参数 | 类型 | 说明 |
@@ -936,6 +1044,8 @@ return StockUNShares(20200924T); //结果：11607850603
## `tSharesOfA(info_id, end_t)`
声明：function
A股总股本，与系统参数(股票)相关。
| 参数 | 类型 | 说明 |
@@ -954,6 +1064,8 @@ return TSharesOfA(16,20230801T);
## `tSharesOfB(info_id, end_t)`
声明：function
B股总股本，与系统参数(股票)相关。
| 参数 | 类型 | 说明 |
@@ -972,6 +1084,8 @@ return TSharesOfB(16,20230801T);
## `shareStructure(bk_name, end_t, low_v, high_v, step_v, value)`
声明：function
返回指定板块指定日期股本结构相关数据。
| 参数 | 类型 | 说明 |