主要内容

bndconvy

Bond convexity given yield

所有的页面崩溃

在R2017B中，可选输入参数的规范已更改。尽管仍然支持先前的有序输入语法，但在将来的版本中可能不再支持它。万博1manbetx使用可选的名称值对输入：时期,基础,EndMonthRule,IssueDate,FirstCouponDate,LastCoupDongate,开始日期,Face,复合频率,折扣， 和LastCouponEnterest.

Syntax

[YeLcavexity，perConvexity] = bndconvy（产量，息票，定居点，成熟）
[YearConvexity，perConvexity] = bndconvy（___，名称，值）

描述

example

[YearConvexity,PerConvexity] = bndconvy(Yield,优惠券比例,Settle,到期)computes the convexity ofNUMBONDS固定收入证券给定每个债券的清洁价格。

bndconvy确定债券的凸度，无论优惠券结构中的第一张还是最后的优惠券期（即息票结构都同步到成熟）。bndconvyalso determines the convexity of a zero coupon bond.

example

[YearConvexity,PerConvexity] = bndconvy(___,名称，价值)添加可选的名称值对参数。

例子

全部收缩

打开实时脚本

This example shows how to compute the convexity of a bond at three different yield values.

产量= [0.04;0.055;0.06];优惠率= 0.055;定居='02-1999';到期='15 -Jun-2004';周期= 2;基础= 0;[YearConvexity，perConvexity] = bndconvy（收益，息票，...Settle, Maturity, Period, Basis)
YeLcevexity =3×121.4825 21.0358 20.8885
perconvexity =3×185.9298 84.1434 83.5541
打开实时脚本

This example shows how to use约会时间inputs to compute the convexity of a bond at three different yield values.

产量= [0.04;0.055;0.06];优惠率= 0.055;定居=约会时间('02-1999','Locale','en_US'）；成熟度= DateTime（'15 -Jun-2004','Locale','en_US'）；周期= 2;基础= 0;[YearConvexity，perConvexity] = bndconvy（收益，息票，...Settle, Maturity, Period, Basis)
YeLcevexity =3×121.4825 21.0358 20.8885
perconvexity =3×185.9298 84.1434 83.5541

输入参数

全部收缩

半年度的成熟度的产量，使用标量或一个标量指定为数字值NUMBONDS-经过-1或者1-经过-NUMBONDS向量。

Data Types:双倍的

年度百分比用于确定应支付的债券支付的优惠券，该债券使用标量或标量指定为十进制价值NUMBONDS-经过-1或者1-经过-NUMBONDS向量。

Data Types:双倍的

Settlement date for the certificate of deposit, specified as a scalar or aNUMBONDS-经过-1或者1-经过-NUMBONDS使用串行日期号，日期字符向量或DateTime数组的向量。TheSettle日期必须在到期日期。

Data Types:双倍的|char|约会时间

定期证书的到期日期，指定为标量或NUMBONDS-经过-1或者1-经过-NUMBONDS使用串行日期号，日期字符向量或DateTime数组的向量。

Data Types:双倍的|char|约会时间

Name-Value Arguments

将可选的参数对Name1=Value1,...,NameN=ValueN， 在哪里Nameis the argument name and价值是相应的值。名称值参数必须在其他参数之后出现，但是对的顺序并不重要。

Before R2021a, use commas to separate each name and value, and encloseNamein quotes.

例子：[YearConvexity，perConvexity] = bndconvy（收益，息料，定居，成熟，'周期'，4，“基础”，7）

每年的优惠券付款数量，指定为逗号分隔的一对'Period'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS使用值：向量：0,1,2,3,4,6, or12.

Data Types:双倍的

Day-count of the instrument, specified as the comma-separated pair consisting of'基础'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS使用支持值的向量：万博1manbetx

  • 0 = actual/actual

  • 1 = 30/360 (SIA)

  • 2 =实际/360

  • 3 = actual/365

  • 4 = 30/360（PSA）

  • 5 = 30/360 (ISDA)

  • 6 = 30/360 (European)

  • 7 = actual/365 (Japanese)

  • 8 = actual/actual (ICMA)

  • 9 =实际/360（ICMA）

  • 10 = actual/365 (ICMA)

  • 11 = 30/360E（ICMA）

  • 12 = actual/365 (ISDA)

  • 13 =巴士/252

有关更多信息，请参阅基础.

Data Types:双倍的

End-of-month rule flag, specified as the comma-separated pair consisting of'EndMonthRule'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS向量。This rule applies only when到期is an end-of-month date for a month having 30 or fewer days.

  • 0=忽略规则，这意味着债券优惠券的付款日期始终是一个月的数字日。

  • 1=设置规则，这意味着债券优惠券付款日期始终是本月的最后一天。

Data Types:logical

债券发行日期，指定为逗号分隔对'IssueDate'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS使用串行日期号，日期字符向量或DateTime数组的向量。

如果您不指定IssueDate，现金流付款日期由其他投入确定。

Data Types:双倍的|char|约会时间

Irregular or normal first coupon date, specified as the comma-separated pair consisting of'FirstCouponDate'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS使用串行日期号，日期字符向量或DateTime数组的向量。

如果您不指定FirstCouponDate，现金流付款日期由其他投入确定。

Data Types:双倍的|char|约会时间

Irregular or normal last coupon date, specified as the comma-separated pair consisting of“ LastCoupdate”和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS使用串行日期号，日期字符向量或DateTime数组的向量。

如果您不指定LastCoupDongate，现金流付款日期由其他投入确定。

Data Types:双倍的|char|约会时间

向前paym的开始日期ents, specified as the comma-separated pair consisting of'StartDate'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS使用串行日期号，日期字符向量或DateTime数组的向量。The开始日期is when a bond actually starts (the date from which a bond cash flow is considered). To make an instrument forward-starting, specify this date as a future date.

如果您不指定开始日期, the effective start date is theSettle日期。

Data Types:双倍的|char|约会时间

Face value of the bond, specified as the comma-separated pair consisting of'脸'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS向量。

Data Types:双倍的

收益率计算的复合频率，指定为逗号分隔对'CompoundingFrequency'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS向量。

  • 1- 年度复合

  • 2— Semiannual compounding

  • 3— Compounding three times per year

  • 4— Quarterly compounding

  • 6— Bimonthly compounding

  • 12- 每月复合

Note

By default, SIA bases (0-7） 和巴士/252使用半年度复合惯例和ICMA基础（8-12）使用年度复合惯例。

Data Types:双倍的

基础used to compute the discount factors for computing the yield, specified as the comma-separated pair consisting of'DiscountBasis'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS向量。值为：

  • 0 = actual/actual

  • 1 = 30/360 (SIA)

  • 2 =实际/360

  • 3 = actual/365

  • 4 = 30/360（PSA）

  • 5 = 30/360 (ISDA)

  • 6 = 30/360 (European)

  • 7 = actual/365 (Japanese)

  • 8 = actual/actual (ICMA)

  • 9 =实际/360（ICMA）

  • 10 = actual/365 (ICMA)

  • 11 = 30/360E（ICMA）

  • 12 = actual/365 (ISDA)

  • 13 =巴士/252

有关更多信息，请参阅基础.

Note

If a SIA day-count basis is defined in the基础input argument and there is no value assigned for折扣, the default behavior is for SIA bases to use the actual/actual day count to compute discount factors.

如果在ICMA日间计数或公共汽车/252中定义基础input argument and there is no value assigned for折扣，指定的基地基础input argument are used.

Data Types:双倍的

在上一个息票期间计算债券收益率的复合惯例，指定为逗号分隔对'LastCouponInterest'和标量或一个NUMBONDS-经过-1或者1-经过-NUMBONDS向量。LastCouponEnterest仅基于最后的优惠券和要偿还的面值。可接受的值是：

  • 简单的

  • 化合物

Data Types:char|细胞

Output Arguments

全部收缩

年度（年度）凸度，返回NUMBONDS-经过-1向量。

时期ic convexity reported on a semiannual bond basis (in accordance with SIA convention), returned as aNUMBONDS-经过-1向量。

参考

[1] Krgin, D.Handbook of Global Fixed Income Calculations.威利，2002年。

[2] Mayle，J。“标准证券计算方法：用于分析措施的固定收益证券公式。”SIA，第2卷，1994年1月。

[3] Stigum，M.，Robinson，F。货币市场和债券计算。麦格劳 - 希尔（McGraw-Hill），1996年。

Version History

在R2006a之前引入

See Also

|||||

Topics