# 金融 / 专题函数 / 债券研究 / 可转债系列01：可转债常用指标 / 转股信息

## `cb_actualSatisfyPutbackDays()`

声明：function

指定日可转债实际满足回售的天数，与系统参数当前证券、当前时间相关。 1）仅考虑指定日在开始回售日和实际到期日之间日期，如果不在，则返回0； 2）还考虑了其使用的计算区间是否跨计息年度、是否一年只有一次回售、是否跨修正转股价日期的问题。比如目前看到，江南转债SH113010 的回售，一个计息年度内有多次。其余可转债没有该情况 3）指定日往前取N个计算天数，有M个交易日满足 正股的收盘价 < 转股价 \* 有条件回售收盘价限制比例(%)，则返回M

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 类型转换 转换 conversion -->

返回：integer

### 示例

范例01：调用 CB_ActualSatisfyPutbackDays

```tsl
Setsysparam(pn_date(), 20201118T);
Setsysparam(pn_Stock(), "SH110072");
return CB_ActualSatisfyPutbackDays();     // 输出：0
```

## `cb_balance()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，转债余额为nil； 2）当指定日在在计息日与实际到期日之间，此时存在两种情况： 1、存在债券.可转债转股及余额表，获取最后一条记录计算 2、不存在债券.可转债转股及余额表，返回发行额

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_Balance

```tsl
SetSysParam(PN_Stock(), "SH110030");
SetSysParam(PN_Date(), inttodate(20190807));
return CB_Balance();
// 输出：401270500（注意：为面额）
```

## `cb_balanceRatio()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，转债余额比例为nil； 2）当指定日在在计息日与实际到期日之间，返回转债余额比例

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：real

### 示例

范例01：调用 CB_BalanceRatio

```tsl
SetSysParam(PN_Stock(), "SH110030");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_BalanceRatio();
// 输出：40.95（注意：40.95%）
```

## `cb_conditionalRedemptionAmount()`

声明：function

返回1）当存在触发收盘价限制赎回条款，返回条件赎回金额； 2）当不存在触发收盘价限制赎回条款，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_ConditionalRedemptionAmount

```tsl
SetSysParam(PN_Stock(), "SH113007");
return CB_ConditionalRedemptionAmount();
// 输出：647151000
```

## `cb_conditionalRedemptionRatio()`

声明：function

返回1）当存在触发收盘价限制赎回条款，返回条件赎回占比； 2）当不存在触发收盘价限制赎回条款，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_ConditionalRedemptionRatio

```tsl
SetSysParam(PN_Stock(), "SH113007");
return CB_ConditionalRedemptionRatio();
// 输出：38.07%
```

## `cb_conRedemptionDays()`

声明：function

返回可转债满足条件赎回天数。当前恒丰转债十分特殊，其计算方式可以以跨计息年度；另外默认所有转债一年可以赎回多次

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：int

### 示例

范例01：调用 CB_ConRedemptionDays

```tsl
SetSysParam(pn_stock(), 'SZ127009');
SetSysParam(pn_date(), 20190828T);
return CB_ConRedemptionDays(); // 输出：15
```

## `cb_conResaleDays()`

声明：function

返回历史上满足条件回售的转债不多，因此大多数返回结果为0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：int

### 示例

范例01：调用 CB_ConResaleDays

```tsl
SetSysParam(pn_stock(), 'SH110031');
SetSysParam(pn_date(), 20190722T);
return CB_ConResaleDays(); // 输出：29
```

## `cb_conUnderrepairDays()`

声明：function

由于下修转股价是发行人的权利，达到下修条款满足天数时，发行人不一定会下修转股价。当满足条件且发行人有回售压力的时候，下修转股价的概率会大些

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 类型转换 转换 conversion -->

返回：int

### 示例

范例01：调用 CB_ConUnderrepairDays

```tsl
SetSysParam(pn_stock(), 'SH110031');
SetSysParam(pn_date(), 20150701T);
return CB_ConUnderrepairDays(); // 输出：5
```

## `cb_cumulativeAdditionResaleAmount()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，返回nil； 2）当指定日在在计息日与实际到期日之间，此时存在两种情况： 1、存在触发附加回售条款，返回累积附加回售金额； 2、不存在触发附加回售条款，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_CumulativeAdditionResaleAmount

```tsl
SetSysParam(PN_Stock(), "SZ123001");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_CumulativeAdditionResaleAmount();
// 输出：25826900
```

## `cb_cumulativeAdditionResaleRatio()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，返回nil； 2）当指定日在在计息日与实际到期日之间，返回累积附加回售占比

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_CumulativeAdditionResaleRatio

```tsl
SetSysParam(PN_Stock(), "SZ123001");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_CumulativeAdditionResaleRatio();
// 输出：1.84%
```

## `cb_cumulativeConditionalResaleAmount()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，累积条件回售金额为nil； 2）当指定日在在计息日与实际到期日之间，此时存在两种情况： 1、存在触发有条件回售条款，返回累积条件回售金额； 2、不存在触发有条件回售条款，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_CumulativeConditionalResaleAmount

```tsl
SetSysParam(PN_Stock(), "SH110030");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_CumulativeConversionRatio();
// 输出：575260000
```

## `cb_cumulativeConditionalResaleRatio()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，返回nil； 2）当指定日在在计息日与实际到期日之间，返回累积条件回售占比

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_CumulativeConditionalResaleRatio

```tsl
SetSysParam(PN_Stock(), "SH110030");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_CumulativeConditionalResaleRatio();
// 输出：58.7%
```

## `cb_cumulativeConversionAmount()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，累积转股余额为nil； 2）当指定日在在计息日与实际到期日之间，此时存在两种情况： 1、存在债券.可转债转股及余额表，计算累积转股余额； 2、不存在债券.可转债转股及余额表，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_CumulativeConversionAmount

```tsl
SetSysParam(PN_Stock(), "SH110030");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_CumulativeConversionAmount();
// 输出：3468456.46
```

## `cb_cumulativeConversionRatio()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，返回nil； 2）当指定日在在计息日与实际到期日之间，返回累积转股占比

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float|datetime

### 示例

范例01：调用 CB_CumulativeConversionRatio

```tsl
SetSysParam(PN_Stock(), "SH110030");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_CumulativeConversionRatio();
// 输出：0.35%
```

## `cb_cumulativeResaleAmount()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，返回nil； 2）当指定日在在计息日与实际到期日之间，此时存在两种情况： 1、存在债券.可转债回售结果表，返回累积回售金额； 2、不存在债券.可转债回售结果表，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_CumulativeResaleAmount

```tsl
SetSysParam(PN_Stock(), "SH110030");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_CumulativeResaleAmount();
// 输出：575260000
```

## `cb_cumulativeResaleRatio()`

声明：function

返回1）当指定日不在在计息日与实际到期日之间，返回nil； 2）当指定日在在计息日与实际到期日之间，返回累积回售占比

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_CumulativeResaleRatio

```tsl
SetSysParam(PN_Stock(), "SZ123001");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_CumulativeResaleRatio();
// 输出：58.7%
```

## `cb_debtToStockRatio()`

声明：function

返回反映可转债转换为正股时摊薄程度 1）当指定日不在在计息日与实际到期日之间，返回nil； 2）当指定日在在计息日与实际到期日之间，返回债转股比例

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_DebtToStockRatio

```tsl
SetSysParam(PN_Stock(), "SH110030");
SetSysParam(PN_Date(), IntToDate(20190807));
return CB_BalanceRatio();
// 输出：2.81（注意：2.81%）
```

## `cb_expireRedemptionAmount()`

声明：function

返回1）当存在触发到期赎回条款，返回到期赎回金额； 2）当不存在触发到期赎回条款，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_ExpireRedemptionAmount

```tsl
SetSysParam(PN_Stock(), "SH110003");
return CB_ExpireRedemptionAmount();
// 输出：2757481000
```

## `cb_expireRedemptionRatio()`

声明：function

返回1）当存在触发余额限制赎回条款，返回限额赎回占比； 2）当不存在触发余额限制赎回条款，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_ExpireRedemptionRatio

```tsl
SetSysParam(PN_Stock(), "SH110003");
return CB_ExpireRedemptionRatio();
// 输出：99.91%
```

## `cb_limitRedemptionAmount()`

声明：function

返回1）当存在触发余额限制赎回条款，返回限额赎回金额； 2）当不存在触发余额限制赎回条款，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_LimitRedemptionAmount

```tsl
SetSysParam(PN_Stock(), "SH113010");
return CB_LimitRedemptionAmount();
// 输出：24032000
```

## `cb_limitRedemptionRatio()`

声明：function

返回1）当存在触发余额限制赎回条款，返回限额赎回占比； 2）当不存在触发余额限制赎回条款，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_LimitRedemptionRatio

```tsl
SetSysParam(PN_Stock(), "SH113010");
return CB_LimitRedemptionRatio();
// 输出：3.16%
```

## `cb_notTransferRatio(end_t)`

声明：function

获取指定日未转股比例(%) ，如果日期大于"实际到期日" 或小于 上市日返回0 未转股比例(%)=未转股数量/发行数量\*100

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 获取 查询 类型转换 -->

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

返回：float

### 示例

范例01：调用 CB_NotTransferRatio

```tsl
Endt := 20201118T;
Setsysparam(pn_Stock(), "SH110072");
return CB_NotTransferRatio(Endt); // 输出：100
```

## `cb_redemptionAmount()`

声明：function

返回1）当存在债券.可转债赎回结果表，返回转债赎回金额； 2）当不存在债券.可转债赎回结果表，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_RedemptionAmount

```tsl
SetSysParam(PN_Stock(), "SH110003");
return CB_RedemptionAmount();
// 输出：2757481000
```

## `cb_redemptionRatio()`

声明：function

返回1）当存在债券.可转债赎回结果表，返回转债赎回占比； 2）当不存在债券.可转债赎回结果表，返回0

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：float

### 示例

范例01：调用 CB_RedemptionRatio

```tsl
SetSysParam(PN_Stock(), "SH110003");
return CB_RedemptionRatio();
// 输出：99.91%
```

## `cb_satisfyPutbackDays(option)`

声明：function

理论上指定日可转债是否满足有条件回售的天数，与系统参数当前证券、当前时间相关。 1）仅考虑指定日在开始回售日和实际到期日之间日期，如果不在，则返回0； 2）还考虑了其使用的计算区间是否跨计息年度 3）指定日往前取N个计算天数，有M个交易日满足 正股的收盘价 < 转股价 \* 有条件回售收盘价限制比例(%)，则返回M

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 类型转换 转换 conversion -->

| 参数     | 类型        | 说明                                                           |
| -------- | ----------- | -------------------------------------------------------------- |
| `option` | user_define | 用户自定义, 条件赎回结果展示选项，可转债赎回天数是否考虑跨年度 |

返回：integer

### 示例

范例01：调用 CB_SatisfyPutbackDays

```tsl
Setsysparam(pn_date(), 20201118T);
Setsysparam(pn_Stock(), "SH110072");
return CB_SatisfyPutbackDays();    // 输出：0
```

## `cb_satisfyRevisedDays()`

声明：function

返回可转债满足下修的天数 ，与系统参数当前证券、当前时间相关。 1）仅考虑指定日在开始下修日和实际到期日之间日期，如果不在，则返回0； 2）连续N个计算天数中有M日满足了下修条件（下修收盘价限制比例），则返回M

<!-- tags: 金融 专题函数 债券研究 01： 可转债系列可转债常用指标 转股信息 查找 搜索 lookup 返回 获取 类型转换 -->

返回：int

### 示例

范例01：调用 CB_SatisfyRevisedDays

```tsl
Setsysparam(pn_date(), 20201118T);
Setsysparam(pn_Stock(), "SH110072");
return CB_SatisfyRevisedDays();  // 输出：21
```
