# 金融 / 行情 / 指定日

## `futuresCZL(end_t)`

声明：function

返回指定日期货合约的次主力合约代码，与系统参数(期货代码)相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明         |
| ------- | ----------- | ------------ |
| `end_t` | t_date_time | 日期。指定日 |

返回：string

### 示例

范例01：调用函数

```tsl
// cu2401在20240616的次主力合约
setSysParam(pn_stock(), 'cu2401');
return futuresCzl(20240616T);
// 输出：cu2408
```

## `futuresIdToZL()`

声明：function

根据期货合约得到主力线，与当前系统证券pn_stock()有关

<!-- tags: 金融 行情 指定日 日期时间 日期 时间 datetime -->

返回：string

### 示例

范例01：调用函数

```tsl
// 根据期货合约al1606得到主力线。
setSysParam(pn_stock(), "AL1606");
return futuresIdToZl ();
// 输出：ZLAL10
```

## `futuresIsTrade(end_t)`

声明：function

判断某期货在当前时间是否还能交易。即判断日期endt是否在当前系统指定合约的交易日（上市日--交割日）之间

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明 |
| ------- | ----------- | ---- |
| `end_t` | t_date_time | 日期 |

返回：integer

### 示例

范例01：调用函数

```tsl
setSysParam(pn_stock(), "al1606");
end_t := intToDate(20160405);
return futuresIsTrade(endt);
// 输出：1
```

## `futuresISZL(end_t)`

声明：function

返回指定日当前期货合约是否是主力合约

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明 |
| ------- | ----------- | ---- |
| `end_t` | t_date_time | 日期 |

返回：boolean

### 示例

范例01：调用函数

```tsl
setSysParam(pn_stock(), 'al1604');
end_t := 20160205T;
return futuresIszl(end_t);
// 输出：1
```

## `futuresZL(end_t)`

声明：function

返回指定日期货合约的主力合约代码。根据当前合约求主力线，再根据主力线求当前主力合约。与当前系统证券pn_stock()有关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明             |
| ------- | ----------- | ---------------- |
| `end_t` | t_date_time | 日期类型，指定日 |

返回：string

### 示例

范例01：调用函数

```tsl
setSysParam(pn_stock(), 'al1603');
end_t := 20160405T;
return futuresZl(end_t);
// 输出：2016年4月5日期货合约al1603的主力合约代码。
```

## `indexPjCj3(price_type)`

声明：function

返回指数平均成交价，与系统参数（证券代码、周期、时间）相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数         | 类型    | 说明                              |
| ------------ | ------- | --------------------------------- |
| `price_type` | integer | 用户自定义。平均价算法，取值如下: |

返回：real

### 示例

范例01：调用函数

```tsl
// 沪深300指数20241108 10:00的5分钟平均成交价(成交量加权平均)
setSysParam(pn_stock(), "SH000300");
setSysParam(pn_cycle(), cy_5m());
setSysParam(pn_date(), 20241108.10T);
return indexPjCj3(1);
// 输出：4163.1544
```

## `ismarketlastdate(endt)`

声明：function

判断指定日期是否为市场的最后一个交易日

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数   | 类型 | 说明          |
| ------ | ---- | ------------- |
| `endt` | date | date,截止日期 |

返回：integer

### 示例

范例01：调用函数

```tsl
setSysParam(pn_cycle(), cy_week());
return ismarketlastdate (20200707T);
// 输出：2020-7-7日是否市场的最后一个交易日
```

## `isMarketTradeDay(end_t)`

声明：function

判断是否为市场交易日

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明           |
| ------- | ---- | -------------- |
| `end_t` | date | 日期，截止日期 |

返回：boolean

### 示例

范例01：调用函数

```tsl
end_t := intToDate(20120420);
return isMarketTradeDay(end_t);
// 输出：20120420是否为市场交易日
```

## `isresumptionordelistconsolidatedate(endt)`

声明：function

判断是否恢复上市首日或者退市整理期首日,是否恢复上市日或者退市整理期，与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数   | 类型 | 说明          |
| ------ | ---- | ------------- |
| `endt` | date | 日期,截止日期 |

返回：integer

### 示例

范例01：调用函数

```tsl
// "SH600705"在20120830T是否恢复上市首日或者退市整理期首日
setSysParam(pn_stock(), "SH600705");
return isresumptionordelistconsolidatedate(20120830T);
// 输出：1
```

## `isrightissuedate(endt)`

声明：function

判断是否增发首日，与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数   | 类型 | 说明          |
| ------ | ---- | ------------- |
| `endt` | date | 日期,截止日期 |

返回：integer

### 示例

范例01：调用函数

```tsl
// "SH600705"在20151214T是否增发首日
setSysParam(pn_stock(), "SH600705");
return isrightissuedate(20151214T);
// 输出：1
```

## `issharessplitdate(endt)`

声明：function

判断是否股权分置首日，与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数   | 类型 | 说明          |
| ------ | ---- | ------------- |
| `endt` | date | 日期,截止日期 |

返回：integer

### 示例

范例01：调用函数

```tsl
// "SH600122"在20060905T是否股权分置首日
setSysParam(pn_stock(), "SH600122");
return issharessplitdate(20060905T);
// 输出：1
```

## `isStockGoDelistingPeriod(end_t)`

声明：function

返回指定日是否处于退市整理期

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：boolean

### 示例

范例01：调用函数

```tsl
// 判断股票SZ000033在2017-5-24日是否处理退市整理期
setSysParam(pn_stock(), 'SZ000033');
return isStockGoDelistingPeriod(20170524T);
// 输出：1
```

## `isStockGoMarket(end_t)`

声明：function

判断是否已上市

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：boolean

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901是否已上市
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return isStockGoMarket(end_t);
// 输出：1
```

## `isStockGoMarket3(endt)`

声明：function

判断是否已上市（且非暂停、终止上市）

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数   | 类型 | 说明     |
| ------ | ---- | -------- |
| `endt` | date | 截止日期 |

返回：boolean

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901是否已上市（且非暂停、终止上市）
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return isStockGoMarket3(end_t);
// 输出：1
```

## `isStockSupending(endt)`

声明：function

返回指定日是否暂停上市，与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数   | 类型        | 说明         |
| ------ | ----------- | ------------ |
| `endt` | t_date_time | 日期。指定日 |

返回：integer

### 示例

范例01：调用函数

```tsl
// SZ300362在20200516T是否暂停上市
setSysParam(pn_stock(), "SZ300362");
return isStockSupending(20200516T);
// 输出：1
```

## `isStockTradeDay(end_t)`

声明：function

返回指定日是否为指定证券的交易日

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明           |
| ------- | ---- | -------------- |
| `end_t` | date | 日期，截止日期 |

返回：boolean

### 示例

范例01：调用函数

```tsl
// 返回SZ000002万科A在20120420这一天是否为交易日
setSysParam(pn_stock(), 'SZ000002');
end_t := intToDate(20120420);
return isStockTradeDay(end_t);
// 输出：1
```

## `istradeday2(indexid, endt)`

声明：function

返回对istradeday的扩展：增加判断港股市场、沪深港通通道的交易日对istradeday的扩展：获取753表的数据，判断市场交易日

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数      | 类型      | 说明               |
| --------- | --------- | ------------------ |
| `indexid` | string    | 市场代码,string    |
| `endt`    | tdatetime | 截止日期,tdatetime |

返回：real

## `isTradeday3(end_t)`

声明：function

返回指定日是否交易日(支持未来日期) 1、EndT为历史交易日期，返回istradeday() 2、EndT为未来日期（包含Today），则根据表127（特别提示-停牌）和市场交易日历判断 注意：这里结果会受到表127更新的影响，由于停牌公告时间原因，比如当日9：00才发停牌公告， 那模型在9：00之前执行和9：00之后执行，可能结果不一致 3、盘中临时停牌时长小于4小数当天仍是交易日

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明  |
| ------- | ----------- | ----- |
| `end_t` | t_date_time | 日期, |

返回：实数

### 示例

范例01：“SH605081”在2026-06-02（相对Today是未来日期）是否交易日

```tsl
// "SH605081"在2026-06-02（相对Today是未来日期）是否交易日
Setsysparam(pn_stock(), 'SH605081'); // 2026-6-2停牌
EndT := 20260602T;
return IsTradeday3(EndT);
// 输出：0
```

## `stock_hsglasttradeday(endt)`

声明：function

与系统参数（股票）相关

<!-- tags: 金融 行情 指定日 日期时间 日期 时间 datetime -->

| 参数   | 类型     | 说明     |
| ------ | -------- | -------- |
| `endt` | datetime | 截止日期 |

返回：integer

## `stock_moMZf(end_t)`

声明：function

返回指定日月度环比涨幅(%)：过去1个月的区间涨幅，与系统证券相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型     | 说明        |
| ------- | -------- | ----------- |
| `end_t` | datetime | 日期,截止日 |

返回：float

### 示例

范例01：调用 Stock_MoMZf

```tsl
setsysparam(pn_stock(), "SH000300");
EndT := 20260203T;
return Stock_MoMZf(EndT);   // 输出：0.65
```

## `stock_qoQZf(end_t)`

声明：function

返回指定日季度环比涨幅(%)：过去1个季度的区间涨幅，与系统证券相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型     | 说明        |
| ------- | -------- | ----------- |
| `end_t` | datetime | 日期,截止日 |

返回：float

### 示例

范例01：调用 Stock_QoQZf

```tsl
setsysparam(pn_stock(), "SH000300");
EndT := 20260203T;
return Stock_QoQZf(EndT);   // 输出：0.14
```

## `stock_yoYZf(end_t)`

声明：function

返回指定日年度同比涨幅(%)：过去1年的区间涨幅，与系统证券相关 年度同比涨幅(%)＝(截止日收盘价-1年前收盘价)/1年前收盘\*100

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型     | 说明        |
| ------- | -------- | ----------- |
| `end_t` | datetime | 日期,截止日 |

返回：float

### 示例

范例01：调用 Stock_YoYZf

```tsl
setsysparam(pn_stock(), "SH000300");
EndT := 20260203T;
return Stock_YoYZf(EndT);   // 输出：22.09
```

## `stockAmountSum4(end_t)`

声明：function

返回成交金额(万)

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的成交金额(万)
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockAmountSum4(end_t);
// 输出：13587.912
```

## `stockAtoBStockClose(end_t)`

声明：function

返回A股对应的B股价格(人民币计价)。与系统参数(证券代码、复权、基准)相关，仅支持A股、日线

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明         |
| ------- | ---- | ------------ |
| `end_t` | date | 日期。截止日 |

返回：real

### 示例

范例01：调用函数

```tsl
// SH600054在20241217对应的B股价格(人民币计价)。
setSysParam(pn_stock(), "SH600054");
return stockAtoBStockClose(20241217T);
// 输出：5.5284
```

## `stockAtoHStockClose(end_t)`

声明：function

返回A股对应的H股价格(人民币计价)。与系统参数(证券代码、复权、基准)相关，仅支持A股、日线

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明         |
| ------- | ---- | ------------ |
| `end_t` | date | 日期。截止日 |

返回：real

### 示例

范例01：调用函数

```tsl
// SH600036在20241217对应的H股价格(人民币计价)。
setSysParam(pn_stock(), "SH600036");
return stockAtoHStockClose(20241217T);
// 输出：34.4488
```

## `stockBigBargainDetail(end_t, beg_minute, end_minute, sep_minute, tradeflag, method_select, standard)`

声明：function

返回大单明细

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数            | 类型        | 说明                                        |
| --------------- | ----------- | ------------------------------------------- |
| `end_t`         | t_date_time | 日期类型，截止日期                          |
| `beg_minute`    | int         | 整数类型，开始时间                          |
| `end_minute`    | int         | 整数类型，截止时间                          |
| `sep_minute`    | int         | 整数类型，（-1:所有;0:时间段;>0:最近N分钟） |
| `tradeflag`     | int         | 整型，交易状态，其取值如下:                 |
| `method_select` | int         | 整型，判断大单标准，其取值如下:             |
| `standard`      | int         | 实数，大单标准                              |

返回：array

## `stockBuyVol4(end_t)`

声明：function

返回主买盘量

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的主买盘量
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockBuyVol4(end_t);
// 输出：7883693
```

## `stockBuyVsSellVolDiff4(end_t)`

声明：function

返回内外盘差

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的内外盘差
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockBuyVsSellVolDiff4(end_t);
// 输出：-917073
```

## `stockCallAuctionAmount(endt, flag)`

声明：function

返回当前证券在指定日集合竞价产生的成交金额，该函数与当前证券相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数   | 类型        | 说明                                             |
| ------ | ----------- | ------------------------------------------------ |
| `endt` | t_date_time | 日期时间，指定日                                 |
| `flag` | integer     | 整型，1 开盘前集合竞价(默认值)，0 收盘前集合竞价 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回万科A在2020-06-22日开盘前集合竞价的成交量。
setSysParam(pn_stock(), 'SZ000002');
return stockCallAuctionAmount(20200622T, 1);
// 输出：16141356
```

## `stockCallAuctionCjbs(endt, flag)`

声明：function

返回当前证券在指定日集合竞价产生的成交笔数，对于期货/期权指持仓变动量。该函数与当前证券相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数   | 类型        | 说明                                             |
| ------ | ----------- | ------------------------------------------------ |
| `endt` | t_date_time | 日期时间，指定日                                 |
| `flag` | integer     | 整型，1 开盘前集合竞价(默认值)，0 收盘前集合竞价 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回万科A在2020-06-22日开盘前集合竞价的成交笔数
setSysParam(pn_stock(), 'SZ000002');
return stockCallAuctionCjbs(20200622T, 1);
// 输出：289
```

## `stockCallAuctionClose(endt, flag)`

声明：function

返回当前证券在指定日集合竞价产生的收盘价，该函数与当前证券、复权、复权基准日相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数   | 类型        | 说明                                             |
| ------ | ----------- | ------------------------------------------------ |
| `endt` | t_date_time | 日期时间，指定日                                 |
| `flag` | integer     | 整型，1 开盘前集合竞价(默认值)，0 收盘前集合竞价 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回万科A在2020-06-22日开盘前集合竞价收盘价。
setSysParam(pn_stock(), 'SZ000002');
return stockCallAuctionClose(20200622T, 1);
// 输出：25.88
```

## `stockcallauctiontradedata(endt, flag)`

声明：function

返回（参考文档未提供简述。）

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数   | 类型    | 说明                                              |
| ------ | ------- | ------------------------------------------------- |
| `endt` | date    | date,指定日                                       |
| `flag` | integer | Integer,集合竞价时段,开盘集合竞价=1收盘集合竞价=0 |

返回：array别名:集合竞价-交易明细

### 示例

范例01：调用函数

```tsl
// 返回万科A在 2020-06-22日开盘前集合竞价期间产生的交易明细
setSysParam(pn_stock(), 'SZ000002');
return stockcallauctiontradedata(20200622T, 1);
```

## `stockCallAuctionVol(endt, flag)`

声明：function

返回当前证券在指定日集合竞价产生的成交量，该函数与当前证券、复权、复权基准日相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数   | 类型        | 说明                                             |
| ------ | ----------- | ------------------------------------------------ |
| `endt` | t_date_time | 日期时间，指定日                                 |
| `flag` | integer     | 整型，1 开盘前集合竞价(默认值)，0 收盘前集合竞价 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回万科A在2020-06-22日开盘前集合竞价的成交量。
setSysParam(pn_stock(), 'SZ000002');
return stockCallAuctionVol(20200622T, 1);
// 输出：623700
```

## `stockClose(end_t)`

声明：function

返回收盘价

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的收盘价
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockClose(end_t);
// 输出：8.14
```

## `stockCloseOfMulti(end_t)`

声明：function

返回收盘，与系统参数（证券代码）相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明          |
| ------- | ----------- | ------------- |
| `end_t` | t_date_time | 日期,截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// "SH600834"在20250623日的价格
setSysParam(pn_stock(), "SH600834");
return stockCloseOfMulti(20250623T);
// 输出：8.37
```

## `stockDtClose(end_t)`

声明：function

返回跌停价，与当前系统证券pn_stock()有关，周期为日线，不复权

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明             |
| ------- | ----------- | ---------------- |
| `end_t` | t_date_time | 日期类型，截止日 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回万科A在2011年9月1日的跌停价。
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockDtClose(end_t);
// 输出：7.34
```

## `stockDtOpen(beg_t_time, end_t_time, trade_time)`

声明：function

统计指定时段内跌停持续达到给定分钟数后价格回升的次数，与系统参数中的证券代码相关

<!-- tags: 金融 行情 指定日 跌停 打开跌停 开板 次数 limit down reopen -->

| 参数         | 类型        | 说明             |
| ------------ | ----------- | ---------------- |
| `beg_t_time` | t_date_time | 开始日期时间     |
| `end_t_time` | t_date_time | 截止日期时间     |
| `trade_time` | integer     | 跌停最短持续分钟 |

返回：integer

### 示例

范例01：统计万科 A 在指定时段内打开跌停的次数

```tsl
setSysParam(pn_stock(), "SZ000002");
beg_t_time := 20150119T + strToDateTime("13:00:00");
end_t_time := 20150119T + strToDateTime("15:00:00");
return stockDtOpen(beg_t_time, end_t_time, 2);
// 输出：2
```

## `stockExtraZf4(end_t, index_id, type)`

声明：function

返回超额收益率(%)

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数       | 类型        | 说明                     |
| ---------- | ----------- | ------------------------ |
| `end_t`    | t_date_time | 日期类型，截止日期       |
| `index_id` | string      | 字符串类型，指数代码     |
| `type`     | integer     | 整数类型，收益率计算方法 |

返回：real

### 示例

范例01：A：返回SZ000002（万科A）相对于上证指数在20110901的超额收益率(%)

```tsl
// A：返回SZ000002（万科A）相对于上证指数在20110901的超额收益率(%)
// 收益率计算方法为涨幅(%)
SetSysParam(PN_Stock(), 'SZ000002');
EndT := inttodate(20110901);
return StockExtraZf4(EndT, 'SH000001', 0);
// 输出：0.3174
```

范例02：B：返回SZ000002（万科A）相对于上证指数在20110901的超额收益率(%):收益率计算方法为对数收益率(%)

```tsl
// B：返回SZ000002（万科A）相对于上证指数在20110901的超额收益率(%):收益率计算方法为对数收益率(%)
SetSysParam(PN_Stock(), 'SZ000002');
EndT := inttodate(20110901);
return StockExtraZf4(EndT, 'SH000001', 1);
// 输出：0.3183
```

## `stockHigh4(end_t)`

声明：function

返回最高价

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的最高价
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockHigh4(end_t);
// 输出：8.19
```

## `stockHsl4(end_t)`

声明：function

返回换手率(%)

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的换手率(%)
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockHsl4(end_t);
// 输出：0.1728
```

## `stockHsl8(end_t)`

声明：function

返回指定日换手率(%)\_支持高频，与系统参数（证券代码，周期）相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型       | 说明                   |
| ------- | ---------- | ---------------------- |
| `end_t` | t_datetime | 日期时间。截止日期时间 |

返回：real

### 示例

范例01：调用函数

```tsl
// "SH600000"在20240925 10：00分钟换手率的涨幅
setSysParam(PN_Stock(), 'SH600000');
setSysParam(PN_Cycle(), cy_1m());
endt := 20240925.1000T;
return stockHsl8(end_t);
// 输出：0.001884
```

## `stockInteriorClose(end_t)`

声明：function

返回指定日收盘（停牌区间发生分红送股, 非复权价），与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明               |
| ------- | ---- | ------------------ |
| `end_t` | date | 日期类型，截止时间 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回上海家化在2011-05-27的是否曾经涨停
setSysParam(pn_stock(), 'SH600315');
return stockInteriorClose(20110527T);
// 输出：36.88
```

## `stockIsCJDt(end_t)`

声明：function

返回指定日是否曾经跌停，与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明               |
| ------- | ---- | ------------------ |
| `end_t` | date | 日期类型，截止时间 |

返回：bool

### 示例

范例01：调用函数

```tsl
// 返回紫金矿业在2021-11-23的是否曾经跌停
setSysParam(pn_stock(), 'SH601899');
return stockIsCjDt(20211123T);
// 输出：0
```

## `stockIsCJZt(end_t)`

声明：function

返回指定日是否曾经涨停，与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明               |
| ------- | ---- | ------------------ |
| `end_t` | date | 日期类型，截止时间 |

返回：bool

### 示例

范例01：调用函数

```tsl
// 返回紫金矿业在2021-11-23的是否曾经涨停
setSysParam(pn_stock(), 'SH601899');
return stockIsCjZt(20211123T);
// 输出：0
```

## `stockIsDt(end_t)`

声明：function

判断是否跌停

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：boolean

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901是否跌停
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockIsDt(end_t);
// 输出：0
```

## `stockIsDt2(end_t)`

声明：function

返回指定日是否一字跌停，与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明               |
| ------- | ---- | ------------------ |
| `end_t` | date | 日期类型，截止时间 |

返回：bool

### 示例

范例01：调用函数

```tsl
// 返回长鹰信质在2016-03-08的是否一字跌停
setSysParam(pn_stock(), 'SZ002664');
return stockIsDt2(20160308T);
// 输出：1
```

## `stockIsFHSP(end_t)`

声明：function

用于某些场景判断指定日是否分红送股

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明          |
| ------- | ---- | ------------- |
| `end_t` | date | 日期,截止日期 |

返回：int

### 示例

范例01：调用函数

```tsl
setSysParam(pn_stock(), "SH000300");
end_t := 20260203T;
return stockIsFhsp(end_t); // 输出：0
```

## `stockISPG(end_t)`

声明：function

用于某些场景判断指定日是否配股

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数    | 类型     | 说明          |
| ------- | -------- | ------------- |
| `end_t` | datetime | 日期,截止日期 |

返回：int

### 示例

范例01：调用函数

```tsl
setsysparam(pn_stock(), "SH000300");
EndT := 20260203T;
return StockISPG(EndT); // 输出：0
```

## `stockIsZt(end_t)`

声明：function

判断是否涨停, 如果当前证券在指定日收盘时涨停则返回1，否则返回0

<!-- tags: 金融 行情 指定日 判断 检查 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：boolean

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901是否涨停
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockIsZt(end_t);
// 输出：0
```

## `stockIsZt2(end_t)`

声明：function

返回指定日是否一字涨停，与当前系统证券pn_stock()有关，周期为日线，不复权

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明             |
| ------- | ----------- | ---------------- |
| `end_t` | t_date_time | 日期类型，截止日 |

返回：bool

### 示例

范例01：调用函数

```tsl
// 返回万科A在2011年9月1日是否一字涨停。
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockIsZt2(end_t);
// 输出：0
```

## `stockLb4(end_t)`

声明：function

返回量比(%)

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的量比(%)
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockLb4(end_t);
// 输出：0.5079
```

## `stockLnZf4(end_t)`

声明：function

返回对数收益率(%)（已复权）

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的对数收益率(%)
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockLnZf4(end_t);
// 输出：-0.1228
```

## `stockLow4(end_t)`

声明：function

返回最低价

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的最低价
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockLow4(end_t);
// 输出：8.1
```

## `stockMaxRateDown4(end_t)`

声明：function

返回最大跌幅(%)（已复权）

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的最大跌幅(%)
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockMaxRateDown4(end_t);
// 输出：-0.6135
```

## `stockMaxRateUp4(end_t)`

声明：function

返回最大涨幅(%)（已复权）

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的最大涨幅(%)
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockMaxRateUp4(end_t);
// 输出：0.4908
```

## `stockOpen4(end_t)`

声明：function

返回开盘价

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的开盘价
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockOpen4(end_t);
// 输出：8.16
```

## `stockPjCj4(end_t)`

声明：function

返回平均成交

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的平均成交
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockPjCj4(end_t);
// 输出：8.1441
```

## `stockPrevClose4(end_t)`

声明：function

返回前收盘价

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的前收盘价
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockPrevClose4(end_t);
// 输出：8.15
```

## `stockPriceZd4(end_t)`

声明：function

返回涨跌金额

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的涨跌金额
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockPriceZd4(end_t);
// 输出：-0.01
```

## `stocksAmountRPS(bk_name, end_t)`

声明：function

返回指定日成交金额得分

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数      | 类型        | 说明                 |
| --------- | ----------- | -------------------- |
| `bk_name` | string      | 字符串类型，板块名称 |
| `end_t`   | t_date_time | 日期类型，截止日期   |

返回：table

### 示例

范例01：调用函数

```tsl
bk := getBkByDate('SH000300', intToDate(20110901));
saveBk('我的沪深300', '用户板块', bk);
end_t := intToDate(20110901);
return stocksAmountRps('我的沪深300', end_t);
// 输出：20110901的用户板块"我的沪深300"的成交金额得分。
```

## `stockSectionalNetBuyAmount2(end_t)`

声明：function

返回指定日资金流向（净买卖），与系统参数（证券代码）相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型 | 说明         |
| ------- | ---- | ------------ |
| `end_t` | date | 日期。截止日 |

返回：real

### 示例

范例01：调用函数

```tsl
// sz000001平安银行在20241108日资金流向（净买卖）
setSysParam(pn_stock(), "SZ000001");
return stockSectionalNetBuyAmount2(20241108T);
// 输出：-245133656.99
```

## `stockSellVol4(end_t)`

声明：function

返回主卖盘量

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的主卖盘量
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockSellVol4(end_t);
// 输出：8800766
```

## `stocksHSLRPS(bk_name, end_t)`

声明：function

返回指定日换手率得分

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数      | 类型        | 说明                 |
| --------- | ----------- | -------------------- |
| `bk_name` | string      | 字符串类型，板块名称 |
| `end_t`   | t_date_time | 日期类型，截止日期   |

返回：table

### 示例

范例01：调用函数

```tsl
bk := getBkByDate('SH000300', intToDate(20110901));
saveBk('我的沪深300', '用户板块', bk);
end_t := intToDate(20110901);
return stocksHslrps('我的沪深300', end_t);
// 输出：20110901的用户板块"我的沪深300"的换手率得分。
```

## `stockSMSDelistingDay(endt)`

声明：function

返回证券进入退市整理期的日期，与系统参数(证券代码)相关

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数   | 类型        | 说明         |
| ------ | ----------- | ------------ |
| `endt` | t_date_time | 日期。指定日 |

返回：integer

### 示例

范例01：调用函数

```tsl
setSysParam(pn_stock(), "SZ000033");
return stockSmsDelistingDay(20170620T);
// 输出：20170524
```

## `stocksRPS(bk_name, end_t)`

声明：function

返回指定日涨幅得分

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数      | 类型        | 说明                 |
| --------- | ----------- | -------------------- |
| `bk_name` | string      | 字符串类型，板块名称 |
| `end_t`   | t_date_time | 日期类型，截止日期   |

返回：table

### 示例

范例01：调用函数

```tsl
bk := getBkByDate('SH000300', intToDate(20110901));
saveBk('我的沪深300', '用户板块', bk);
end_t := intToDate(20110901);
return stocksRps('我的沪深300', end_t);
// 输出：20110901的用户板块"我的沪深300"的涨幅得分。
```

## `stockTrailingSharpeRatioByEndt(endt, ref_type)`

声明：function

获取基于指定日推移阶段的夏普比率

<!-- tags: 金融 行情 指定日 获取 查询 日期时间 日期 时间 datetime -->

| 参数       | 类型        | 说明                                  |
| ---------- | ----------- | ------------------------------------- |
| `endt`     | date        | 日期,截止日                           |
| `ref_type` | user_define | 用户自定义，选择所推移类型，取值如下: |

返回：real

### 示例

范例01：调用函数

```tsl
// 获取沪深300过去1年的夏普比率
setSysParam(pn_stock(), "SH000300");
setSysParam("Rf", 2.5); // 设置年化无风险收益率(%),可选设置
endt := 20210714t;
ref_type := 4; // 过去1年
return stockTrailingSharpeRatioByEndt(endt, ref_type); // 输出：0.02
```

## `stockTWAP4(end_t, beg_time, end_time)`

声明：function

计算区间段的交易时间加权平均价格

<!-- tags: 金融 行情 指定日 计算 求解 日期时间 日期 时间 datetime -->

| 参数       | 类型       | 说明                         |
| ---------- | ---------- | ---------------------------- |
| `end_t`    | t_datetime | 日期，截止日期               |
| `beg_time` | t_datetime | 时间，开始时间，可以精确到秒 |
| `end_time` | t_datetime | 时间，截止时间，可以精确到秒 |

返回：real

### 示例

范例01：调用函数

```tsl
// 计算"SZ000002"在2019年9月25日九点半到十点交易时间加权平均价格
setSysParam(pn_stock(), "SZ000002");
end_t := intToDate(20190925);
beg_time := strToTime("09:30:00");
end_time := strToTime("10:00:00");
return stockTwap4(end_t, beg_time, end_time);
// 输出：26.01262712
```

## `stockVolSum4(end_t)`

声明：function

返回成交量(手)

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的成交量(手)
setSysParam(PN_Stock(), 'SZ000002');
setSysParam(PN_Rate(), 1);
setSysParam(PN_RateDay(), intToDate(20110901));
end_t := intToDate(20110901);
return stockVolSum4(end_t);
// 输出：166844.59
```

## `stockVWAP4(end_t, beg_time, end_time)`

声明：function

计算日内区间段的成交量加权平均价

<!-- tags: 金融 行情 指定日 计算 求解 日期时间 日期 时间 datetime -->

| 参数       | 类型       | 说明                         |
| ---------- | ---------- | ---------------------------- |
| `end_t`    | t_datetime | 日期，截止日期               |
| `beg_time` | t_datetime | 时间，开始时间，可以精确到秒 |
| `end_time` | t_datetime | 时间，截止时间，可以精确到秒 |

返回：real

### 示例

范例01：调用函数

```tsl
// 计算"SZ000002"在2019年9月25日九点半到十点成交量加权平均价
setSysParam(pn_stock(), "SZ000002");
end_t := intToDate(20190925);
beg_time := strToTime("09:30:00");
end_time := strToTime("10:00:00");
return stockVwap4(end_t, beg_time, end_time);
// 输出：26.00209696
```

## `stockZdf4(end_t)`

声明：function

返回振幅(%)（已复权）

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型     | 说明               |
| ------- | -------- | ------------------ |
| `end_t` | datetime | 日期类型，截止日期 |

返回：float

### 示例

范例01：调用函数

```tsl
SetSysParam(PN_Stock(), 'SZ000002');
EndT := inttodate(20110901);
return StockZdf4(EndT);
```

## `stockZf4(end_t)`

声明：function

返回涨幅(%)

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `end_t` | t_date_time | 日期类型，截止日期 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回SZ000002（万科A）在20110901的涨幅(%)
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockZf4(end_t);
// 输出：-0.1227
```

## `stockzflimit(endt)`

声明：function

返回涨跌停幅度

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数   | 类型 | 说明        |
| ------ | ---- | ----------- |
| `endt` | date | 日期,截止日 |

返回：array

### 示例

范例01：调用函数

```tsl
// "SZ000002"在2021-06-22涨跌停幅度
setSysParam(pn_stock(), "SZ000002");
return stockzflimit(20210622T);
// 输出：array(("涨停幅度(%)":10,"跌停幅度(%)":-10))
```

## `stockZfLimitDownRate(end_t)`

声明：function

返回跌停幅度

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明        |
| ------- | ----------- | ----------- |
| `end_t` | t_date_time | 日期,截止日 |

返回：实数

### 示例

范例01：调用函数

```tsl
// "SZ000002"在2021-06-22跌停幅度
setSysParam(pn_stock(), "SZ000002");
setSysParam(PN_Date(), 20210622T);
return stockZfLimitDownRate(20210622T);
// 输出：-10.00
```

## `stockZfLimitUpRate(end_t)`

声明：function

返回涨停幅度

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明        |
| ------- | ----------- | ----------- |
| `end_t` | t_date_time | 日期,截止日 |

返回：实数

### 示例

范例01：调用函数

```tsl
// "SZ000002"在2021-06-22涨停幅度
setSysParam(pn_stock(), "SZ000002");
setSysParam(PN_Date(), 20210622T);
return stockZfLimitUpRate(20210622T);
// 输出：10.00
```

## `stockZtClose(end_t)`

声明：function

返回涨停价，与当前系统证券pn_stock()有关，周期为日线，不复权

<!-- tags: 金融 行情 指定日 返回 获取 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明             |
| ------- | ----------- | ---------------- |
| `end_t` | t_date_time | 日期类型，截止日 |

返回：real

### 示例

范例01：调用函数

```tsl
// 返回万科A在2011年9月1日的涨停价。
setSysParam(PN_Stock(), 'SZ000002');
end_t := intToDate(20110901);
return stockZtClose(end_t);
// 输出：8.97
```

## `stockZtOpen(beg_t_time, end_t_time, trade_time)`

声明：function

统计指定时段内涨停持续达到给定分钟数后价格回落的次数，与系统参数中的证券代码相关

<!-- tags: 金融 行情 指定日 涨停 打开涨停 开板 次数 limit up reopen -->

| 参数         | 类型        | 说明             |
| ------------ | ----------- | ---------------- |
| `beg_t_time` | t_date_time | 开始日期时间     |
| `end_t_time` | t_date_time | 截止日期时间     |
| `trade_time` | integer     | 涨停最短持续分钟 |

返回：integer

### 示例

范例01：统计万科 A 在指定时段内打开涨停的次数

```tsl
setSysParam(pn_stock(), "SZ000002");
beg_t_time := 20151218T + strToDateTime("09:00:00");
end_t_time := 20151218T + strToDateTime("13:20:00");
return stockZtOpen(beg_t_time, end_t_time, 1);
// 输出：1
```

## `stockztordtclose(flag)`

声明：function

支持品种：A股，基金(ETF;LOF;Reits)，可转债，期货，期权

<!-- tags: 金融 行情 指定日 日期时间 日期 时间 datetime ETF LOF -->

| 参数   | 类型    | 说明                           |
| ------ | ------- | ------------------------------ |
| `flag` | integer | 整型,涨跌停标志(0:涨停;1:跌停) |

返回：实数

### 示例

范例01："SH688067"在2021-06-22涨停价格(上市第二天)

```tsl
// "SH688067"在2021-06-22涨停价格(上市第二天)
SetSysParam(pn_stock(), "SH688067");
SetSysParam(PN_Date(), 20210622T);
return StockZtOrDtClose(0);
// 输出：0
```

范例02："SZ000002"在2021-06-22涨停价格

```tsl
// "SZ000002"在2021-06-22涨停价格
SetSysParam(pn_stock(), "SZ000002");
SetSysParam(PN_Date(), 20210622T);
return StockZtOrDtClose(0);
// 输出：26.62
```

## `adjustmentFactor(rate_day)`

声明：function

返回从复权基准日到系统时间的比例复权因子，与系统参数中的证券代码和系统时间相关。支持股票、ETF、LOF 和可转债；模型考虑股权分置改革的分红送股，不考虑权证。复权价格等于收盘价乘以复权因子

<!-- tags: 金融 行情 指定日 复权 复权因子 股票 ETF LOF 可转债 -->

| 参数       | 类型        | 说明                         |
| ---------- | ----------- | ---------------------------- |
| `rate_day` | t_date_time | 可选。复权基准日，默认上市日 |

返回：real

### 示例

范例01：以上市日为基准日取得复权因子

```tsl
setSysParam(pn_stock(), 'SH603117');
setSysParam(pn_date(), 20180702T);
return adjustmentFactor();
// 输出：1.01472183639756
```

范例02：计算以上市日为基准的复权价格

```tsl
setSysParam(pn_stock(), 'SH603117');
setSysParam(pn_date(), 20191112T);
return simpleRoundTo(close() * adjustmentFactor(), -2);
// 输出：5.31
```

范例03：指定复权基准日

```tsl
setSysParam(pn_stock(), 'SH603117');
setSysParam(pn_date(), 20191112T);
rate_day := 20200721T;
return adjustmentFactor(rate_day);
// 输出：0.98989898989899
```

## `stockZtOrDtCloseOfMD(flag)`

声明：function

返回交易所提供的涨停价或跌停价，与系统参数中的证券代码和系统时间相关

<!-- tags: 金融 行情 指定日 涨停 跌停 涨跌停价 交易所 -->

| 参数   | 类型    | 说明           |
| ------ | ------- | -------------- |
| `flag` | integer | 涨停或跌停标志 |

flag 取值

- `0` — 涨停
- `1` — 跌停

返回：real

### 示例

范例01：取得科创板股票上市第二天的涨停价

```tsl
setSysParam(pn_stock(), 'SH688067');
setSysParam(pn_date(), 20210622T);
return stockZtOrDtCloseOfMD(0);
// 输出：0
```

范例02：取得深市股票的涨停价

```tsl
setSysParam(pn_stock(), 'SZ000002');
setSysParam(pn_date(), 20210622T);
return stockZtOrDtCloseOfMD(0);
// 输出：26.62
```

## `zlToFuturesId(zlid, end_t)`

声明：function

根据主力线或者连续合约得到具体合约

<!-- tags: 金融 行情 指定日 日期时间 日期 时间 datetime -->

| 参数    | 类型        | 说明               |
| ------- | ----------- | ------------------ |
| `zlid`  | string      | 字符串类型，主力线 |
| `end_t` | t_date_time | 日期类型，截止日   |

返回：string

### 示例

范例01：调用函数

```tsl
// 根据沪铝主力线ZLAL10得到具体合约。
end_t := 20160429T;
return zlToFuturesId ('ZLAL10', end_t);
// 输出：al1607
```
