📦 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,208 @@
+# 金融 / 期货 / 仓单日报
+
+## `futuresTheWarehouseVolRatio(warehouse)`
+
+声明：function
+
+与系统参数(期货品种代码、时间)相关
+
+<!-- tags: 金融 期货 仓单日报 -->
+
+| 参数        | 类型   | 说明   |
+| ----------- | ------ | ------ |
+| `warehouse` | string | 仓库名 |
+
+返回：real
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+// 返回截止日为20200518，仓库国储天威关于SN（锡）占该地区仓单总量比(%)
+setSysParam(pn_stock(), 'sn');
+setSysParam(pn_date(), 20200518T);
+return futuresTheWarehouseVolRatio("国储天威");
+```
+
+## `futuresWarehouseChange(warehouse, region)`
+
+声明：function
+
+与系统参数(期货品种代码、时间)相关 1、当Warehouse、Region为空时，为仓单净变动量； 2、当Warehouse为空、Region为地区名时，为上期所-指定地区仓单净变动量； 3、当Warehouse为仓库名、Region为空时，为指定仓库仓单净变动量； 4、当Warehouse为仓库名、Region为地区名时，为上期所-指定地区仓库仓单净变动量， 5、单位： 1)上期所：黄金、白银：千克，其他品种：吨； 2)大商所：手 3)郑商所：张
+
+<!-- tags: 金融 期货 仓单日报 -->
+
+| 参数        | 类型   | 说明   |
+| ----------- | ------ | ------ |
+| `warehouse` | string | 仓库名 |
+| `region`    | string | 地区名 |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+SetSysParam(pn_stock(), 'sn');
+SetSysParam(pn_date(), 20200518T);
+return FuturesWarehouseChange("", "上海");
+```
+
+## `futuresWarehousePredictionVol(warehouse)`
+
+声明：function
+
+与系统参数(期货品种代码、时间)相关 1、当Warehouse为空时，为有效预报总量； 2、当Warehouse为仓库名时，为指定仓库有效预报总量， 3、注：本函数只用于郑州商品交易所 4、单位： 1)上期所：黄金、白银：千克，其他品种：吨； 2)大商所：手 3)郑商所：张
+
+<!-- tags: 金融 期货 仓单日报 -->
+
+| 参数        | 类型   | 说明   |
+| ----------- | ------ | ------ |
+| `warehouse` | string | 仓库名 |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+SetSysParam(pn_stock(), 'SR');
+SetSysParam(pn_date(), 20200518T);
+return FuturesWarehousePredictionVol();
+```
+
+## `futuresWarehouseRatio(warehouse, region)`
+
+声明：function
+
+与系统参数(期货品种代码、时间)相关。 1、当Warehouse、Region为空时，为仓单变比(%)； 2、当Warehouse为空、Region为地区名时，为上期所-指定地区仓单变比(%)； 3、当Warehouse为仓库名、Region为空时，为指定仓库仓单变比(%)； 4、当Warehouse为仓库名、Region为地区名时，为上期所-指定地区仓库仓单变比(%)， 5、算法：仓单净变动量/前一交易日仓单总量\*100%
+
+<!-- tags: 金融 期货 仓单日报 -->
+
+| 参数        | 类型   | 说明   |
+| ----------- | ------ | ------ |
+| `warehouse` | string | 仓库名 |
+| `region`    | string | 地区名 |
+
+返回：float
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+SetSysParam(pn_stock(), 'sn');
+SetSysParam(pn_date(), 20200518T);
+return FuturesWarehouseRatio();
+```
+
+## `futuresWarehouseRatio2(warehouse, region)`
+
+声明：function
+
+与系统参数(期货品种代码、时间)相关
+
+<!-- tags: 金融 期货 仓单日报 -->
+
+| 参数        | 类型   | 说明   |
+| ----------- | ------ | ------ |
+| `warehouse` | string | 仓库名 |
+| `region`    | string | 地区名 |
+
+返回：real
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+// 返回截止日为20200518，仓库国储天威关于SN（锡）的仓单变比(%)
+setSysParam(pn_stock(), 'sn');
+setSysParam(pn_date(), 20200518T);
+return futuresWarehouseRatio2("国储天威");
+```
+
+## `futuresWarehouseVol(warehouse, region)`
+
+声明：function
+
+与系统参数(期货品种代码、时间)相关
+
+<!-- tags: 金融 期货 仓单日报 -->
+
+| 参数        | 类型   | 说明   |
+| ----------- | ------ | ------ |
+| `warehouse` | string | 仓库名 |
+| `region`    | string | 地区名 |
+
+返回：real
+
+### 示例
+
+范例01：调用函数
+
+```tsl
+// 返回截止日为20200518，仓库国储天威关于SN（锡）的仓单总量
+setSysParam(pn_stock(), 'sn');
+setSysParam(pn_date(), 20200518T);
+return futuresWarehouseVol("国储天威");
+```
+
+## `getFuturesDailyWarehouse(beg_t, end_t, t)`
+
+声明：function
+
+获取指定品种指定时间段的仓单日报数据。注意，设置系统参数pn_stock为品种代码，比如setsysparam(pn_stock(),'CF')，参考范例
+
+<!-- tags: 金融 期货 仓单日报 获取 查询 CF -->
+
+| 参数    | 类型        | 说明                           |
+| ------- | ----------- | ------------------------------ |
+| `beg_t` | t_date_time | 开始日                         |
+| `end_t` | t_date_time | 截止日                         |
+| `t`     | array       | 返回满足查询条件的仓单日报数据 |
+
+返回：bool
+
+### 示例
+
+范例01：获取"CF"品种一段时间的仓单日报
+
+```tsl
+// 获取"CF"品种一段时间的仓单日报
+
+SetSysParam(pn_stock(), "CF");
+
+begt := 20140415T;
+
+endt := 20140419T;
+
+Ret := GetFuturesDailyWarehouse(Begt, Endt, t);
+
+If Ret then // 查询成功
+
+    Return t;
+
+Else
+```
+
+范例02：获取"CF"品种一段时间的仓单日报
+
+```tsl
+// 获取"CF"品种一段时间的仓单日报
+
+SetSysParam(pn_stock(), "CF");
+
+begt := 20140415T;
+
+endt := 20140419T;
+
+Ret := GetFuturesDailyWarehouse(Begt, Endt, t);
+
+If Ret then // 查询成功
+
+    Return "获取数据失败";
+```