# 期货 / 仓单日报

## `futuresRegion(warehouse)`

仓库所在的地区，与系统参数(期货品种代码、时间)相关。注：本函数只用于上海期货交易所。

| 参数        | 类型   | 说明           |
| ----------- | ------ | -------------- |
| `warehouse` | string | 字符串。仓库名 |

返回：string

### 示例

```tsl
SetSysParam(pn_stock(),"CU");
setsysparam(pn_date(),20210401T);
return FuturesRegion("南储仓储");
```

## `futuresWarehouse(sign, warehouse, region)`

仓单日报数据汇总(按条件)，与系统参数(期货品种代码、日期)相关。 单位：上期所：黄金、白银：千克，其他品种：吨； 大商所：手 郑商所：张

| 参数        | 类型   | 说明                            |
| ----------- | ------ | ------------------------------- |
| `sign`      | int    | 用户自定义。字段标志，取值如下: |
| `warehouse` | string | 字符串。仓库名                  |
| `region`    | string | 字符串。地区                    |

返回：实数

### 示例

```tsl
SetSysParam(PN_Stock(),'cu');
SetSysParam(PN_date(),20210401T);
Return FuturesWarehouse(0,'南储仓储','广东');
```

## `futuresWarehouseChange(warehouse, region)`

与系统参数(期货品种代码、时间)相关 1、当Warehouse、Region为空时，为仓单净变动量； 2、当Warehouse为空、Region为地区名时，为上期所-指定地区仓单净变动量； 3、当Warehouse为仓库名、Region为空时，为指定仓库仓单净变动量； 4、当Warehouse为仓库名、Region为地区名时，为上期所-指定地区仓库仓单净变动量， 5、单位： 1)上期所：黄金、白银：千克，其他品种：吨； 2)大商所：手 3)郑商所：张

| 参数        | 类型   | 说明   |
| ----------- | ------ | ------ |
| `warehouse` | string | 仓库名 |
| `region`    | string | 地区名 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),'sn');
SetSysParam(pn_date(),20200518T);
return FuturesWarehouseChange("","上海");
```

## `futuresWarehousePredictionVol(warehouse)`

与系统参数(期货品种代码、时间)相关 1、当Warehouse为空时，为有效预报总量； 2、当Warehouse为仓库名时，为指定仓库有效预报总量， 3、注：本函数只用于郑州商品交易所 4、单位： 1)上期所：黄金、白银：千克，其他品种：吨； 2)大商所：手 3)郑商所：张

| 参数        | 类型   | 说明   |
| ----------- | ------ | ------ |
| `warehouse` | string | 仓库名 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),'SR');
SetSysParam(pn_date(),20200518T);
return FuturesWarehousePredictionVol();
```

## `futuresWarehouseRatio(warehouse, region)`

与系统参数(期货品种代码、时间)相关。 1、当Warehouse、Region为空时，为仓单变比(%)； 2、当Warehouse为空、Region为地区名时，为上期所-指定地区仓单变比(%)； 3、当Warehouse为仓库名、Region为空时，为指定仓库仓单变比(%)； 4、当Warehouse为仓库名、Region为地区名时，为上期所-指定地区仓库仓单变比(%)， 5、算法：仓单净变动量/前一交易日仓单总量\*100%

| 参数        | 类型   | 说明   |
| ----------- | ------ | ------ |
| `warehouse` | string | 仓库名 |
| `region`    | string | 地区名 |

返回：float

### 示例

```tsl
SetSysParam(pn_stock(),'sn');
SetSysParam(pn_date(),20200518T);
return FuturesWarehouseRatio();
```

## `getFuturesDailyWarehouse(beg_t, end_t, t)`

获得指定品种指定时间段的仓单日报数据。注意，设置系统参数pn_stock为品种代码，比如setsysparam(pn_stock(),'CF')，参考范例。

| 参数    | 类型      | 说明                           |
| ------- | --------- | ------------------------------ |
| `beg_t` | TDateTime | 开始日                         |
| `end_t` | TDateTime | 截止日                         |
| `t`     | Array     | 返回满足查询条件的仓单日报数据 |

返回：Bool

### 示例

```tsl
//获取"CF"品种一段时间的仓单日报
setSysParam(pn_stock(),"CF");
begt:=20140415T;
endt:=20140419T;
ret:=getFuturesDailyWarehouse(begt,endt,t);
if ret then //查询成功
return t;
else
return "获取数据失败";
```

## `futuresWarehouseVol(warehouse, region)`

与系统参数(期货品种代码、时间)相关

| 参数        | 类型   | 说明   |
| ----------- | ------ | ------ |
| `warehouse` | String | 仓库名 |
| `region`    | String | 地区名 |

返回：real

### 示例

```tsl
//返回截止日为20200518，仓库国储天威关于SN（锡）的仓单总量
setSysParam(pn_stock(),'sn');
setSysParam(pn_date(),20200518T);
return futuresWarehouseVol("国储天威");
```

## `futuresWarehouseRatio2(warehouse, region)`

与系统参数(期货品种代码、时间)相关

| 参数        | 类型   | 说明   |
| ----------- | ------ | ------ |
| `warehouse` | String | 仓库名 |
| `region`    | String | 地区名 |

返回：real

### 示例

```tsl
//返回截止日为20200518，仓库国储天威关于SN（锡）的仓单变比(%)
setSysParam(pn_stock(),'sn');
setSysParam(pn_date(),20200518T);
return futuresWarehouseRatio2("国储天威");
```

## `futuresTheWarehouseVolRatio(warehouse)`

与系统参数(期货品种代码、时间)相关

| 参数        | 类型   | 说明   |
| ----------- | ------ | ------ |
| `warehouse` | String | 仓库名 |

返回：real

### 示例

```tsl
//返回截止日为20200518，仓库国储天威关于SN（锡）占该地区仓单总量比(%)
setSysParam(pn_stock(),'sn');
setSysParam(pn_date(),20200518T);
return futuresTheWarehouseVolRatio("国储天威");
```
