✨ feat(tsl-api-reference): expand and reorganize api catalog

Flatten builtin pages, add third-party and platform scopes, and import financial and data warehouse references. Keep the existing generated index without rebuilding after signature normalization.
2026-08-10 18:26:24 +08:00
parent 2938300acb
commit 9010829c6d
1186 changed files with 243901 additions and 219769 deletions
@@ -0,0 +1,295 @@
+# 金融 / 基本面 / 基本
+
+## `basicInfoEx3()`
+
+声明：function
+
+返回三大报表的基本面信息
+
+返回：array
+
+### 示例
+
+范例01：返回基本面信息
+
+```tsl
+return BasicInfoEx3();
+// 输出：基本面信息
+```
+
+## `basicInfoExt2()`
+
+声明：function
+
+获取基本面信息，比BasicInfoEx3返回的信息基本更全面
+
+返回：array
+
+### 示例
+
+范例01：调用 BasicInfoExt2
+
+```tsl
+Return BasicInfoExt2();
+```
+
+## `getLastReportFinance(id, timeable)`
+
+声明：function
+
+获取报告最后的财务值；
+
+| 参数       | 类型    | 说明                         |
+| ---------- | ------- | ---------------------------- |
+| `id`       | integer | 整数，基本面ID；             |
+| `timeable` | bool    | 布尔值，表示是否和时间相关； |
+
+返回：real
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+o_v := BackUpSystemParameters2();
+// 取浦发银行最后报告的资产总计
+setSysParam(pn_stock(), 'SH600000');
+v := getLastReportFinance(44059, 0);
+return v;
+// 输出：3468442000000
+```
+
+## `getReportFinanceByTime(id, timeable, next, day)`
+
+声明：function
+
+查找比当前日期大的报告期数据；与当前股票相关
+
+| 参数       | 类型     | 说明                         |
+| ---------- | -------- | ---------------------------- |
+| `id`       | int      | 整数，基本面ID；             |
+| `timeable` | bool     | 布尔值，表示是否和时间相关； |
+| `next`     | bool     | 布尔值，表示是否向后查找；   |
+| `day`      | datetime | 日期；                       |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+oV := BackUpSystemParameters2();
+setsysparam(pn_stock(), 'SH600000');
+endt := inttodate(20130909);
+v := GetReportFinanceByTime(44059, 0, 0, endt);
+return v;
+// 输出：3468442000000
+```
+
+## `getReportFinanceByTime2(id, time)`
+
+声明：function
+
+财务报告，查找比当前日期小的报告期的财务数据
+
+| 参数   | 类型    | 说明                         |
+| ------ | ------- | ---------------------------- |
+| `id`   | integer | 整数，基本面ID;              |
+| `time` | boolean | 布尔值，表示是否和时间相关； |
+
+返回：real
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+o_v := BackUpSystemParameters2();
+// 取浦发银行比当前日期小的报告期的资产总计数据
+setSysParam(pn_stock(), 'SH600000');
+v := getReportFinanceByTime2(44059, 0);
+return v;
+// 输出：3468442000000
+```
+
+## `idToDate(id)`
+
+声明：function
+
+报告期ID->日期，将报告期转换为具体的日期的整数形式，月份是00的话将表示某年的的第几周转化为具体日期的整数值，否则直接返回ID
+
+| 参数 | 类型    | 说明   |
+| ---- | ------- | ------ |
+| `id` | integer | 报告期 |
+
+返回：integer
+
+### 示例
+
+范例01：返回2012年第10周对应的日期的整数值
+
+```tsl
+return IDToDate(20120010);
+// 输出：20120309
+```
+
+范例02：返回2011年年报对应的日期的整数值
+
+```tsl
+return IDToDate(20111231);
+// 输出：20111231
+```
+
+## `idToStr(report_id)`
+
+声明：function
+
+将报告期以中文形式输出，如：20120331则输出2012年第一季报，如果月份为00并且日小于54(一年的周数)，则输出第几周，如：20120012，则输出2012年第12周报；
+
+| 参数        | 类型    | 说明     |
+| ----------- | ------- | -------- |
+| `report_id` | integer | 报告日期 |
+
+返回：string
+
+### 示例
+
+范例01：返回”2011年年报”
+
+```tsl
+return IDToStr(20111231);
+// 输出："2011年年报"
+```
+
+范例02：结果：”2012年第12周报”
+
+```tsl
+return idtostr(20120012);
+// 输出："2012年第12周报"
+```
+
+## `ifArrayId(id)`
+
+声明：function
+
+判断是否为表格类型
+
+| 参数 | 类型    | 说明     |
+| ---- | ------- | -------- |
+| `id` | integer | 基本面ID |
+
+返回：boolean
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+return ifArrayId(44);
+// 输出：1，表示44是表格类型
+```
+
+## `ifBaseId(id)`
+
+声明：function
+
+判断要取得的数据是否与报告期无关
+
+| 参数 | 类型    | 说明                                               |
+| ---- | ------- | -------------------------------------------------- |
+| `id` | integer | 基本面表格中某一字段的ID，如44002，是表44的002字段 |
+
+返回：boolean
+
+### 示例
+
+范例01：返回1，表示与报告期无关
+
+```tsl
+return IfBaseID(65000);
+// 输出：1
+```
+
+范例02：返回0，表示与报告期相关
+
+```tsl
+return IfBaseID(44002);
+// 输出：0
+```
+
+## `ifReportId(id)`
+
+声明：function
+
+判断要取得的数据是否与报告期相关
+
+| 参数 | 类型    | 说明                                                 |
+| ---- | ------- | ---------------------------------------------------- |
+| `id` | integer | 基本面表格中某一字段对应的ID，如44002，表44的002字段 |
+
+返回：boolean
+
+### 示例
+
+范例01：返回1，表示与报告期相关
+
+```tsl
+return IfReportID(44002);
+// 输出：1
+```
+
+范例02：返回0，表示与报告期无关
+
+```tsl
+return IfReportID(65000);
+// 输出：0
+```
+
+## `infoArrayEx(info_id, rdate)`
+
+声明：function
+
+获取证券在报告期RDate的InfoId基本面数据，与系统当前股票有关
+
+| 参数      | 类型    | 说明     |
+| --------- | ------- | -------- |
+| `info_id` | integer | 基本面ID |
+| `rdate`   | integer | 报告期   |
+
+返回：array
+
+### 示例
+
+范例01：返回万科年报的合并资产负债表
+
+```tsl
+SetSysParam(pn_stock(), "SZ000002");
+
+return InfoArrayEx(44, 20111231);
+// 输出：万科年报的合并资产负债表
+```
+
+## `infoIdExt(id, r_date)`
+
+声明：function
+
+截止日不大于RDate的最近的id值，与系统参数(证券)相关，对于财务数据还与系统参数(日期)相关
+
+| 参数     | 类型    | 说明                         |
+| -------- | ------- | ---------------------------- |
+| `id`     | integer | 整数。财务指标和其他信息的ID |
+| `r_date` | integer | 整数。截止日，报告期ID       |
+
+返回：real
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setSysParam(PN_Stock(), 'OF000001');
+rendt := dateToInt(20200411T); // 星期六
+return infoIdExt(328003, rendt);
+// 返回的星期五净值InfoIdExt(328003,20200410):1.11
+```