✨ feat(tsl-api): add parameter value domain lookup

2026-08-22 14:15:54 +08:00
parent 476f999139
commit b101b13bba
17 changed files with 2551 additions and 400 deletions
@@ -67,13 +67,15 @@ return GetBKBacktrackByDate("SWHY740000", 20140805T);

 声明：function

-获取指数历史指定日的成份股列表。与GetBK不同，该函数需要的第一个参数是指数代码，获取该指数的指定日的成分股，比如沪深300定期调整，在不同时间获取的成分股将不同。 新增功能，当ExType=1时指数成分中取不到成分时，则从权重表中获取
+获取指数或分类属性在指定日的成份股列表。与getBk不同，该函数需要日期参数；普通指数使用
+指数代码，行业或基金分类使用分类属性代码。新增功能，当ExType=1时指数成分中取不到成分时，
+则从权重表中获取

-<!-- tags: 金融 指数 指数情况 获取 查询 -->
+<!-- tags: 金融 指数 指数情况 历史成份股 分类属性代码 下级分类 SWHY CAPCHY CSRCHY YHFL TSJJ02 TSJJ03 TSI000001 TSI000002 TSI000003 TSI000004 TSI000005 TSI000006 TSI000007 TSI000008 TSI000009 获取 查询 -->

 | 参数       | 类型     | 说明                                                                                  |
 | ---------- | -------- | ------------------------------------------------------------------------------------- |
-| `index_id` | string   | 指数代码                                                                              |
+| `index_id` | string   | 指数代码、分类属性代码或 TSI 市场板块代码                                             |
 | `end_t`    | datetime | 截止日                                                                                |
 | `extype`   | int      | 整型,是否扩展，默认不扩展；0:不扩展；1:扩展取数（指数成分表无数据时，从权重表中获取） |

@@ -95,6 +97,37 @@ Return GetBkByDate('SH000300', inttodate(20120908));
 return GetBKByDate("SZ399102", 20201201T, 1); // 取权重中的成份股替代
 ```

+范例03：取指定日申万分类的下级属性代码
+
+```tsl
+return GetBKByDate("SWHY.N", 20210423T, 0);
+```
+
+范例04：取指定日申万分类的成份股
+
+```tsl
+return GetBKByDate("SWHY740000", 20220101T, 0);
+```
+
+范例05：取指定日 A 股市场板块的成份股
+
+```tsl
+return GetBKByDate("TSI000001", 20230810T, 0);
+```
+
+范例06：取指定日投资风格分类下的基金
+
+```tsl
+return GetBKByDate("TSJJ0201", 20220101T, 0);
+```
+
+`index_id` 使用分类属性代码时，代码末尾的 `.N` 表示返回该分类节点在指定日的下级
+分类属性代码；不带 `.N` 时返回该分类节点的成份券。常用根分类包括股票的 `SWHY`、
+`CAPCHY`、`CSRCHY`，以及基金的 `YHFL`、`TSJJ02`、`TSJJ03`。分类目录信息和分类归属
+信息分别见股票表 138、139 及基金表 355、356；不能把分类属性代码当作个券代码传给归属表。
+级数为 0 的根代码本身没有成份券；要先用根代码加 `.N` 取得一级分类代码。`CSRCHY`
+自 2024-02-19 起不再维护，此后使用 `CAPCHY`。
+
 ## `getBkByIndexName(index_name, end_t)`

 声明：function
@@ -100,7 +100,7 @@ return isValueBetweeMaxAndMin(t, 'close', 0, 5);

 声明：function

-返回市场常用列表，仅包括深证A股、深证B股、深证基金、上证A股、上证B股、上证基金。如果需要获得其他目录下的板块列表，请使用函数GetBKList，使用方法参见该函数的函数说明
+返回市场常用列表，仅包括深证A股、深证B股、深证基金、上证A股、上证B股、上证基金。如果需要获得其他目录下的板块列表，请使用函数getBkList，使用方法参见该函数的函数说明

 <!-- tags: 金融 板块 基本情况 其它 返回 获取 -->

@@ -146,7 +146,7 @@ Return GetHyDyFlDetails('行业');

 声明：function

-获取行业/地域/分类的列表，用于替代GetBKList
+获取行业/地域/分类的列表，用于替代getBkList

 <!-- tags: 金融 股票 行业 获取 查询 -->

@@ -168,7 +168,7 @@ Return GetHyDyFlList('行业');

 声明：function

-获取行业的股票。取代GetBK，比其更精确
+获取行业的股票。取代getBk，比其更精确

 <!-- tags: 金融 股票 行业 获取 查询 -->