📦 deps(tsl): sync tsl-playbook from a71480a4

Source-Commit: a71480a4ae
2026-08-12 08:38:08 +08:00
parent 683f83d17c
commit 670ba950a6
1496 changed files with 292667 additions and 220122 deletions
@@ -0,0 +1,460 @@
+# 数据仓库 / 向导函数 / N期
+
+## `accOfNReport(exp, report_id, n, report_type, if_stand, return_type)`
+
+声明：function
+
+N期加速度算子
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型     | 说明                                                                                                     |
+| ------------- | -------- | -------------------------------------------------------------------------------------------------------- |
+| `exp`         | expr     | 表达式类型，计算相关财务指标，一般与报告期相关，如TTM归属母公司净利润:@Last12MData(DefaultRepID(),46078) |
+| `report_id`   | datetime | 报告期                                                                                                   |
+| `n`           | int      | 整数，最近N期                                                                                            |
+| `report_type` | int      | 报告期类型                                                                                               |
+| `if_stand`    | bool     | 布尔类型，回归数据是否标准化                                                                             |
+| `return_type` | int      | 整型，返回类型                                                                                           |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setsysparam(pn_stock(), "SH600519");?
+return ACCOfNReport(@Last12MData(DefaultRepID(), 46078), 20201231, 8, 1);
+```
+
+## `avgOfNReport(exp, report_id, n, report_type)`
+
+声明：function
+
+当前时间ReportID向前推N年，返回从ReportID-N到ReportID时间报告期Exp指标平均值，与系统参数(股票)相关
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型 | 说明                             |
+| ------------- | ---- | -------------------------------- |
+| `exp`         | expr | 函数表达式                       |
+| `report_id`   | int  | 报告期                           |
+| `n`           | int  | 整数，期数                       |
+| `report_type` | int  | 整数，0：年度，1：季度，默认年度 |
+
+返回：float
+
+### 示例
+
+范例01：返回：84785000000
+
+```tsl
+SetSysParam(pn_stock(), 'SZ000001');
+
+return AvgOfNReport(@reportofall(46002, DefaultRepID()), 20151231, 2);
+// 输出：84785000000
+```
+
+范例02：返回：24794000000
+
+```tsl
+SetSysParam(pn_stock(), 'SZ000001');
+
+return AvgOfNReport(@LastQuarterData(DefaultRepID(), 46002, 0), 20151231, 2, 1);
+// 输出：24794000000
+```
+
+## `continuedMatchOfNReport(exp, report_id, n)`
+
+声明：function
+
+当前时间ReportID向前推N年，若从ReportID-N到ReportID时间均存在报告Exp则返回1，否则返回0，与系统参数(股票)相关
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数        | 类型 | 说明           |
+| ----------- | ---- | -------------- |
+| `exp`       | expr | 布尔公式表达式 |
+| `report_id` | int  | 报告期         |
+| `n`         | int  | 整数           |
+
+返回：bool
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+判断2014到2015这两年平安银行年报是否全部存在
+SetSysParam(pn_stock(), 'SZ000001');
+return ContinuedMatchOfNReport(@reportofall(46002, GetSysParam('DefaultRepID')), 20151231, 2);
+```
+
+## `eaaOfNReport(exp, report_id, last_report_type)`
+
+声明：function
+
+N期加速度EAA
+
+<!-- tags: 数据仓库 向导函数 N 期 EAA -->
+
+| 参数               | 类型     | 说明                                                                                                     |
+| ------------------ | -------- | -------------------------------------------------------------------------------------------------------- |
+| `exp`              | expr     | 表达式类型，计算相关财务指标，一般与报告期相关，如TTM归属母公司净利润:@Last12MData(DefaultRepID(),46078) |
+| `report_id`        | datetime | 报告期                                                                                                   |
+| `last_report_type` | int      | 整数，上期报告期类型                                                                                     |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setsysparam(pn_stock(), "SH600519");
+Exp := @LastQuarterData(DefaultRepID(), 46078);
+ReportID := 20211231;
+LastReportType := 0;
+t := EAAOfNReport(Exp, ReportID, LastReportType);
+return t;   // -0.016
+```
+
+## `eavOfNReport(exp, report_id, n, report_type, last_report_type)`
+
+声明：function
+
+N期加速度EAV
+
+<!-- tags: 数据仓库 向导函数 N 期 EAV -->
+
+| 参数               | 类型     | 说明                                                                                                     |
+| ------------------ | -------- | -------------------------------------------------------------------------------------------------------- |
+| `exp`              | expr     | 表达式类型，计算相关财务指标，一般与报告期相关，如TTM归属母公司净利润:@Last12MData(DefaultRepID(),46078) |
+| `report_id`        | datetime | 报告期                                                                                                   |
+| `n`                | int      | 整数，最近N期                                                                                            |
+| `report_type`      | int      | 报告期类型                                                                                               |
+| `last_report_type` | int      | 整数，上期报告期类型                                                                                     |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setsysparam(pn_stock(), "SH600519");
+Exp := @LastQuarterData(DefaultRepID(), 46078);
+ReportID := 20200930;
+N := 8;
+ReportType := 1; // 0：年度，1：季度
+LastReportType := 0;
+t := EAVOfNReport(Exp, ReportID, N, ReportType, LastReportType);
+return t;    // -0.45
+```
+
+## `growthOfNReport(exp, report_id, n, return_type)`
+
+声明：function
+
+当前时间ReportID向前推N年，返回从ReportID-N与ReportID表达式Exp指标的增长比例，其中returntype决定增长模式，与系统参数(股票)相关
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型 | 说明                 |
+| ------------- | ---- | -------------------- |
+| `exp`         | expr | 函数表达式           |
+| `report_id`   | int  | 报告期               |
+| `n`           | int  | 整数                 |
+| `return_type` | int  | 用户自定义，返回类型 |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+返回平安银行2014年与2015年报营业收入增长比例
+SetSysParam(pn_stock(), 'SZ000001');
+return GrowthOfNReport(@reportofall(46002, GetSysParam('DefaultRepID')), 20151231, 1, 1);
+```
+
+## `highestOfNReport(exp, report_id, n, report_type)`
+
+声明：function
+
+表达式N期最高
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型   | 说明              |
+| ------------- | ------ | ----------------- |
+| `exp`         | string | 字符串,函数表达式 |
+| `report_id`   | int    | 整数,报告期       |
+| `n`           | int    | 整数,期数         |
+| `report_type` | int    | 整数,报告期类型   |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+SetSysParam(pn_stock(), "SH600585");
+return HighestOfNReport(@ReportOfAll(46080, DefaultRepID()), 20221231, 5, 0);
+```
+
+## `highGrowthOfNReport(exp, report_id, n, report_type, range)`
+
+声明：function
+
+N期高速增长拐点：最近N期中，第N期数据上升且大于前N-1期极差的range倍 max=max(前N-1期数据） min=min(前N-1期数据） 第N期>上期+range\*(max-min)
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型     | 说明                                                                                                     |
+| ------------- | -------- | -------------------------------------------------------------------------------------------------------- |
+| `exp`         | expr     | 表达式类型，计算相关财务指标，一般与报告期相关，如TTM归属母公司净利润:@Last12MData(DefaultRepID(),46078) |
+| `report_id`   | datetime | 报告期                                                                                                   |
+| `n`           | int      | 整数，最近N期                                                                                            |
+| `report_type` | int      | 报告期类型                                                                                               |
+| `range`       | float    | 实数，前N-1期极差的Range倍，用于衡量高速增长的幅度，默认取3                                              |
+
+返回：bool
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setsysparam(pn_stock(), "SZ002340");
+Exp := @LastQuarterData(GetSysParam('DefaultRepID'), 9900604);
+ReportID := 20210331;
+N := 5;
+ReportType := 1; // 0：年度，1：季度
+Range := 3;
+t := HighGrowthOfNReport(Exp, ReportID, N, ReportType, Range);
+return t;     // 1
+```
+
+## `lowestOfNReport(exp, report_id, n, report_type)`
+
+声明：function
+
+表达式N期最低
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型   | 说明              |
+| ------------- | ------ | ----------------- |
+| `exp`         | string | 字符串,函数表达式 |
+| `report_id`   | int    | 整数,报告期       |
+| `n`           | int    | 整数,期数         |
+| `report_type` | int    | 整数,报告期类型   |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+SetSysParam(pn_stock(), "SH600585");
+return lowestOfNReport(@ReportOfAll(46080, DefaultRepID()), 20221231, 5, 0);
+```
+
+## `occuredOfNReport(exp, report_id, n)`
+
+声明：function
+
+当前时间ReportID向前推N年，返回从ReportID-N到ReportID时间发生报告Exp的次数，与系统参数(股票)相关
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数        | 类型 | 说明           |
+| ----------- | ---- | -------------- |
+| `exp`       | expr | 布尔公式表达式 |
+| `report_id` | int  | 报告期         |
+| `n`         | int  | 整数           |
+
+返回：int
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+返回平安银行截止到2015年12月31日的所有年报数量
+SetSysParam(pn_stock(), 'SZ000001');
+returnOccuredOfNReport(@reportofall(46002, GetSysParam('DefaultRepID')), 20151231, 100);
+```
+
+## `refReportValue(exp, report_id, n)`
+
+声明：function
+
+当前时间ReportID向前推N年，返回ReportID-N时间点表达式 Exp指标值，与系统参数(股票)相关
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数        | 类型 | 说明       |
+| ----------- | ---- | ---------- |
+| `exp`       | expr | 函数表达式 |
+| `report_id` | int  | 报告期     |
+| `n`         | int  | 整数       |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+返回平安银行2015年年报营业收入额
+SetSysParam(pn_stock(), 'SZ000001');
+return RefReportValue(@reportofall(46002, GetSysParam('DefaultRepID')), 20161231, 1);
+```
+
+## `robustACCOfNReport(exp, report_id, n, report_type, last_report_type)`
+
+声明：function
+
+N期稳健加速度
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数               | 类型     | 说明                                                                                                                                       |
+| ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `exp`              | expr     | 表达式类型，计算相关财务指标，一般与报告期相关，通常以增长率来表示增速。；如TTM净利润增长率(%)表达式为@Last12MData(DefaultRepID(),9900604) |
+| `report_id`        | datetime | 报告期                                                                                                                                     |
+| `n`                | int      | 整数，最近N期                                                                                                                              |
+| `report_type`      | int      | 报告期类型                                                                                                                                 |
+| `last_report_type` | int      | 整数，上期报告期类型，默认与ReportType取值相同（兼容历史）                                                                                 |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setsysparam(pn_stock(), "SH600519");
+return RobustACCOfNReport(@Last12MData(DefaultRepID(), 9900604), 20201231, 8, 0); // -0.0878801178157446
+```
+
+## `robustGrowthOfNReport(exp, report_id, n, report_type)`
+
+声明：function
+
+过去N期稳健增速，与系统证券相关
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型         | 说明                                                                   |
+| ------------- | ------------ | ---------------------------------------------------------------------- |
+| `exp`         | t_expression | 表达式类型，计算相关财务指标，一般与报告期相关，通常以增长率来表示增速 |
+| `report_id`   | r_date       | 报告期                                                                 |
+| `n`           | int          | 整数，最近N期                                                          |
+| `report_type` | int          | 报告期类型                                                             |
+
+返回：real
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setSysParam(pn_stock(), "SH600519");
+return robustGrowthOfNReport(@last12MData(defaultRepId(), 9900604),
+    20201231, 8, 0); // 0.916987656203954
+```
+
+## `standGrowthOfNReport(exp, report_id, n, report_type)`
+
+声明：function
+
+N期标准化增长率
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型     | 说明                                                                                                     |
+| ------------- | -------- | -------------------------------------------------------------------------------------------------------- |
+| `exp`         | expr     | 表达式类型，计算相关财务指标，一般与报告期相关，如TTM归属母公司净利润:@Last12MData(DefaultRepID(),46078) |
+| `report_id`   | datetime | 报告期                                                                                                   |
+| `n`           | int      | 整数，最近N期                                                                                            |
+| `report_type` | int      | 报告期类型                                                                                               |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setsysparam(pn_stock(), "SH600519");
+Exp := @LastQuarterData(GetSysParam('DefaultRepID'), 46078);
+ReportID := 20211231;
+N := 8;
+ReportType := 1; // 0：年度，1：季度
+t := StandGrowthOfNReport(Exp, ReportID, N, ReportType);
+return t;   // 1.265
+```
+
+## `sumOfNReport(exp, report_id, n)`
+
+声明：function
+
+当前时间ReportID向前推N年，返回从ReportID-N到ReportID时间报告期Exp指标和，与系统参数(股票)相关
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数        | 类型 | 说明       |
+| ----------- | ---- | ---------- |
+| `exp`       | expr | 函数表达式 |
+| `report_id` | int  | 报告期     |
+| `n`         | int  | 整数，期数 |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+计算平安银行2015年报与2014年报营业收入的和
+SetSysParam(pn_stock(), 'SZ000001');
+return SumOfNReport(@reportofall(46002, GetSysParam('DefaultRepID')), 20151231, 2);
+```
+
+## `turnPositiveOfNReport(exp, report_id, n, report_type)`
+
+声明：function
+
+N期转正拐点：最近N期中，前N-1期数据小于0，第N期数据大于0
+
+<!-- tags: 数据仓库 向导函数 N 期 -->
+
+| 参数          | 类型     | 说明                                                                                                     |
+| ------------- | -------- | -------------------------------------------------------------------------------------------------------- |
+| `exp`         | expr     | 表达式类型，计算相关财务指标，一般与报告期相关，如TTM归属母公司净利润:@Last12MData(DefaultRepID(),46078) |
+| `report_id`   | datetime | 报告期                                                                                                   |
+| `n`           | int      | 整数，最近N期                                                                                            |
+| `report_type` | int      | 报告期类型                                                                                               |
+
+返回：bool
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+setsysparam(pn_stock(), "SH600110");
+Exp := @LastQuarterData(GetSysParam('DefaultRepID'), 42017);  // 季度扣非净利润
+ReportID := 20210331;
+N := 5;
+ReportType := 1; // 0：年度，1：季度
+t := TurnPositiveOfNReport(Exp, ReportID, N, ReportType);
+return t;   // 1
+```