✨ feat(tsl-api-reference): expand API and module coverage

2026-08-14 17:12:55 +08:00
parent 8f1056130d
commit 3d3036ebe1
571 changed files with 47842 additions and 14458 deletions
@@ -842,6 +842,31 @@ v := StockShare (20120830T);
 return v;
 ```

+## `stockShares(end_t, return_field)`
+
+声明：function
+
+返回指定证券在指定日期的某类股本数量，单位为股
+
+<!-- tags: 金融 股票 股本结构 股本数量 总股本 流通股 shares capital structure -->
+
+| 参数           | 类型        | 说明     |
+| -------------- | ----------- | -------- |
+| `end_t`        | t_date_time | 指定日期 |
+| `return_field` | string      | 股本类别 |
+
+返回：real
+
+### 示例
+
+范例01：查询万科 A 的总股本
+
+```tsl
+setSysParam(pn_stock(), "SZ000002");
+return stockShares(20120830T, sss_totalSharesField());
+// 输出：10995210218
+```
+
 ## `stockShares3(return_field)`

 声明：function
@@ -868,6 +893,33 @@ v := StockShares3(SSS_TotalSharesField());
 return v;
 ```

+## `stockSharesRatio(end_t, share_name_1, share_name_2)`
+
+声明：function
+
+计算指定证券两类股本的比例，结果为第一类股本除以第二类股本再乘以 100
+
+<!-- tags: 金融 股票 股本结构 股本比例 流通股 总股本 shares ratio capital structure -->
+
+| 参数           | 类型        | 说明         |
+| -------------- | ----------- | ------------ |
+| `end_t`        | t_date_time | 指定日期     |
+| `share_name_1` | string      | 分子股本类别 |
+| `share_name_2` | string      | 分母股本类别 |
+
+返回：real
+
+### 示例
+
+范例01：计算万科 A 流通股占总股本的比例
+
+```tsl
+setSysParam(pn_stock(), "SZ000002");
+return stockSharesRatio(
+    20120830T, sss_nSharesField(), sss_totalSharesField());
+// 输出：87.874955
+```
+
 ## `stockSOShares(end_t)`

 声明：function