playbook/skills/tsl-api-reference/references/codegen/dotnet/bond/yield.md

债券 / 债券收益率

bdAdjustedDuration(end_t, return_value)

返回指定债券指定日修正久期，该函数和证券代码有关。

参数	类型	说明
end_t	datetime	时间区间的截止日期
return_value	float	修正久期

返回：float

bdCoupDayBs(end_t, return_value)

返回指定债券当前付息期内截止到交易日的天数，该函数和证券代码有关。

参数	类型	说明
end_t	datetime	时间区间的截止日期
return_value	any	当前付息期内截止到交易日的天数

返回：float

bdDuration3(return_value)

返回指定债券久期，该函数和证券代码有关。

参数	类型	说明
return_value	float	债券久期

返回：float

bdRemainPayNumber(end_t, return_value)

返回指定债券指定日剩余付息次数，该函数和证券代码有关。

参数	类型	说明
end_t	datetime	时间区间的截止日期。
return_value	float	指定日剩余付息次数

返回：float

bdRemainYear(end_t, return_value)

返回指定债券指定日剩余年限(年)，该函数和证券代码有关。

参数	类型	说明
end_t	datetime	时间区间的截止日期
return_value	float	指定日剩余年限(年)

返回：float

bdYtm3()

返回指定债券到期收益率(%)，该函数和证券代码有关。

返回：float

bondAccruedInterest(option, model_method)

指定日债券的应计利息。在不设置数据供应商的情况下，默认先调用中证数据，没有值时再调用TS算法处理。若直接调用TS算法，设置供应商pn_ bonddataprovider()为2。 应计利息是指从上次付息日到结算日（购买日）债券所应该支付的应计利息。针对不同的债券，应付利息采取不同的算法： 定期付息应计利息，见模型BondAccruedInterest1说明 到期一次还本付息应计利息，见模型BondAccruedInterest2说明 零息债券应计利息，见模型BondAccruedInterest3说明 此模型为常见债券计算应付利息的总接口

参数	类型	说明
option	datetime	函数返回结果类型
model_method	int	算法模型

返回：float

示例

获得代码SH010107在20171218T的日间应计利息-现金流算法
Setsysparam(pn_Stock(),”SH010107”);
Setsysparam(pn_bonddataprovider(),2);//数据供应商选择TS计算
Endt:=20171218T;
Return BondInterest(Endt,0);

bondAccruedInterest1(par, coupon, f, t, ts)

银行间债券周期性付息的应计利息中间函数。

参数	类型	说明
par	float	实数，剩余本金
coupon	float	本期票面利率(%)
f	int	年付息频率
t	int	计息日到结算日的实际天数（含2月29）
ts	any	当前周期的实际天数(算头不算尾，周期不是完整周期时表示的是虚拟的下个付息日（计息日为基准）与上个付息日的天数 含2月29)

返回：float

bondAccruedInterest2(par, coupon, k, ty)

银行间债券到期一次还本付息的应计利息

参数	类型	说明
par	float	面值
coupon	float	票面利率(%)，本期利率(%)
k	int	计息日到结算日的整年数(按实际天数处理,计息日为基准)；:上一理论付息日（计息日为基准按照周期性付息频率为1处理的上个付息日）到结算日的实际天数（含2月29）
ty	int	本期年度计息天数(以计息日为基准的年度天数含2月29

返回：float

bondAccruedInterest3(par, pd)

零息债券的应计利息中间函数

参数	类型	说明
par	float	实数，面值
pd	float	实数，债券发行价；T1:整数，起息日至到期兑付日的实际天数；:整数，起息日至结算日的实际天数

返回：float

bondAccruedInterest4(settlement_date)

固定利率债券的应计利息

参数	类型	说明
settlement_date	datetime	结算日

返回：float

bondAccruedInterest5(par, coupon, t)

交易所债券-周期性付息或者到期一次还本付息的应计利息

参数	类型	说明
par	float	实数。剩余本金
coupon	float	实数。本期利率(%)
t	int	整数。已计息天数

返回：float

bondCouponExt(settlement_date)

债券-结算日票面利率，与系统股票pn_stock()有关

参数	类型	说明
settlement_date	datetime	日期类型，结算日

返回：float

示例

Setsysparam(pn_Stock(),"BK000000");
return BondCouponExt(20120703T);

bondDaysNewestPayment(settlement_date, option)

当前计息年度的实际天数，与系统参数(证券代码)相关。

参数	类型	说明
settlement_date	datetime	日期。结算日
option	int	用户自定义。方法，取值如下:

返回：int

示例

Setsysparam(pn_Stock(),"BK010004");
return BondDaysNewestPayment(20120703T,1);

bondDirtyPrice(settlement_date)

债券全价 全价交易是指债券价格中把应计利息包含在债券报价中的债券交易。应计利息是指从上次付息日到结算日（购买日）债券所应该支付的应计利息。 目前在常见数据提供商提供的债券数据中（沪深交易所债券2002年后，银行间债券2001年7月后），都是以净价披露的。 即：债券全价=债券净价+应付利息 在净价交易制度下,交易系统直接实行净价报价,同时显示债券成交价格和应计利息额,并以两项之和为债券买卖价格；结算系统直接实行净价结算,以债券成交价格与应计利息额之和为债券结算交割价格。也就是说,在债券现券买卖中,债券的报价采用净价,而实际买卖价格和结算交割价格为全价

参数	类型	说明
settlement_date	datetime	结算日

返回：float

bondYieldToMaturity(settlement_date)

指定日的到期收益率（%）。在不设置数据供应商的情况下，默认先调用中证数据，没有值时再调用TS算法处理。若直接调用TS算法，设置供应商pn_ bonddataprovider()为2。 针对不同的债券，不同的代偿期，到期收益率采取不同的算法： 到期收益率(最后付息周期的定期付息债、待偿期在一年及以内的到期一次还本付息债券和零息债券)，见函数BondYieldToMaturity1说明 到期收益率(待偿期在一年以上的到期一次还本付息债券和零息债券)，见函数BondYieldToMaturity2说明 到期收益率(不处于最后付息周期的定期付息债)，见函数BondYieldToMaturity3说明 此模型为常见债券计算到期收益率的总接口

参数	类型	说明
settlement_date	datetime	结算日；Option:是否行权

返回：float

示例

债券SH010107在20171228日收盘买入持有到到期的收益率
Endt:=20171228T;
Setsysparam(pn_Stock(),"SH010107");
Setsysparam(pn_bonddataprovider(),2);//数据供应商选择TS计算
Return BondYieldToMaturity(Endt);

bondYieldToMaturity1(pv, fv, d, ty)

最后付息周期的定期付息债、待偿期在一年及以内的到期一次还本付息债券和零息债券的到期收益率 其中： y： 到期收益率； FV：到期兑付日债券本息和 PV：债券全价 D：债券结算日至到期兑付日的实际天数 TY：当前计息年度的实际天数，算头不算尾

参数	类型	说明
pv	float	实数，债券全价
fv	float	实数，债券到期兑付现金流（本息和）
d	int	整数，结算日到到期日的实际天数。（含2月29）
ty	int	整数，本期计息年度实际天数（计息起始日为基准，含2月29）

返回：float

bondYieldToMaturity2(pv, fv, d)

待偿期在一年以上的到期一次还本付息债券和零息债券的到期收益率 ：债券全价 ：到期兑付日债券本息和 ： 到期收益率 ：结算日至下一最近理论付息日的实际天数 ：结算日至到期兑付日的整年数 TY ：当前计息年度的实际天数，算头不算尾

参数	类型	说明
pv	float	实数，债券全价
fv	float	实数，到期兑付日债券本息和
d	int	整数，结算日至下一最近理论付息日的实际天数；TY:整数，当前计息年度的实际天数；m:整数，结算日至到期兑付日的整年数

返回：float

bondYieldToMaturity3(pv)

规则付息且非最后付息周期债券的到期收益率中间函数。付息次数处理—完整周期采用+1，非完整周期计算比例。（非完整周期主要是首个周期以及最后付息周期）。

参数	类型	说明
pv	float	实数，债券全价；CashFlow:数组，未来现金流数据，字段见现金流返回值。；f:整数，频率；d:整数，债券结算日至下一付息日之间的实际天数(含2月29)；TS :整数，当前付息周期的实际天数（计息日为基准，含2月29）

返回：float

bondYieldTomaturity4(settlementdate, cash_flow, pv)

债券付息不规则的到期收益率。

参数	类型	说明
settlementdate	datetime	日期。指定日期
cash_flow	array	数组。债券现金流
pv	float	实数。现价

返回：float

bondYieldToMaturityIi(amortised_cost, settlement_date, option)

到期收益率(%)-摊余成本法，与系统股票pn_stock()有关

参数	类型	说明
amortised_cost	float	实数，摊余成本
settlement_date	datetime	日期类型，结算日
option	any	用户自定义，取值如下:

返回：float

isBondPayRegular(settlement_date, option)

指定日付息是否规则。

参数	类型	说明
settlement_date	datetime	日期。指定日期
option	int	用户自定义。是否行权，取值如下:

返回：int

isBondPayRugularByCash(cash_flow, period)

现金流数据是否规则付息。

参数	类型	说明
cash_flow	array	数组。债券现金流
period	int	整数。频率

返回：int

midBondYieldToMaturity(settlementdate, cash_f_low, pv, f)

到期收益率(%)--中间函数。

参数	类型	说明
settlementdate	datetime	日期。截止日期
cash_f_low	array	数组。债券指定日未来现金流
pv	float	实数。债券价格
f	any	整数。付息频率

返回：float

bondCleanPrice(settlement_date)

债券净价

参数	类型	说明
settlement_date	TDateTime	结算日

返回：Real

bondFutureValue()

到期兑付日债券本息和，与系统股票pn_stock()有关

返回：Real

示例

//返回’ BK000002’的到期兑付日债券本息和
setSysParam(PN_Stock(),'BK000002');
return bondFutureValue();
//结果：102.8