主要内容

bndtotalreturn

固定息票债券的总收益

折叠所有页面

语法

[BondEquiv, EffectiveRate] = bndtotalreturn(价格、CouponRate解决、成熟度、ReinvestRate)
[BondEquiv, EffectiveRate] = bndtotalreturn (___、名称、值)

描述

实例

[BondEquiv,EffectiveRate) = bndtotalreturn (价格,耦合率,解决,成熟,再投资)计算固定息债券到期日或特定投资期限的总回报。

[BondEquiv,EffectiveRate) = bndtotalreturn (___,名称、值)添加可选的名称-值对参数。

例子

全部崩溃

打开实时脚本

使用bndtotalreturn计算给定投资期限的固定息债券的总收益。

定义固定息票债券。

价格= 101;CouponRate = 0.05;解决=“15 - 11月- 2011”；成熟=“15 - 11月- 2031”；再投资=0.04；

计算到期总回报率。

[BondEquiv，EffectiveRate]=BND总回报（价格、耦合率、，．..解决、成熟度、ReinvestRate)
BondEquiv = 0.0460
有效汇率=0.0466

指定投资期限。

HorizonDate =“15 - 11月- 2021”；[BondEquiv，EffectiveRate]=BND总回报（价格、耦合率、，．..解决、成熟度、ReinvestRate“HorizonDate”，日期）
BondEquiv=0.0521
EffectiveRate = 0.0528

对再投资率进行情景分析。

ReinvestRate = (0.03;0.035;0.04;0.045;0.05);[BondEquiv，EffectiveRate]=BND总回报（价格、耦合率、，．..解决、成熟度、ReinvestRate“HorizonDate”，日期）
BondEquiv =5×10.0557 0.0538 0.0521 0.0505 0.0490
EffectiveRate =5×10.0565 0.0546 0.0528 0.0511 0.0496
打开实时脚本

使用bndtotalreturn具有日期时间给定投资期限日期，计算固定息票债券总回报的输入。

价格=101；耦合率=0.05；结算=日期时间(“15 - 11月- 2011”,“区域设置”,“en_US”)；到期日=日期时间(“15 - 11月- 2031”,“区域设置”,“en_US”）;HorizonDate = datetime (“15 - 11月- 2021”,“区域设置”,“en_US”)；再投资=0.04；[BondEquiv，EffectiveRate]=bndtotalreturn（价格、耦合率、，．..解决、成熟度、ReinvestRate“HorizonDate”，日期）
BondEquiv=0.0521
EffectiveRate = 0.0528

输入参数

全部崩溃

结算日的净价，指定为标量或NINST——- - - - - -1.向量。

数据类型:双

息票率，指定为标量或NINST——- - - - - -1.十进制值的向量。

数据类型:双

固定息票债券的结算日期，指定为标量或aNINST——- - - - - -1.序列日期数字、日期字符向量或日期时间数组的向量。如果作为NINST——- - - - - -1.矢量的日期，结算日期可以不同，只要是在前成熟日期和水平日期．

数据类型:双|字符|日期时间

固定息债券的到期日，指定为标量或NINST——- - - - - -1.由串行日期号、日期字符向量或日期时间数组组成的向量。

数据类型:双|字符|日期时间

再投资率(通过将息票再投资而获得的利率)，指定为标量或NINST——- - - - - -2.十进制值的向量。

数据类型:双

名称值参数

指定可选的逗号分隔的字符对名称、值参数。的名字是参数名和价值是对应的值。的名字必须出现在引号内。您可以按任意顺序指定多个名称和值对参数，如下所示：Name1, Value1,…,的家．

例子:[BondEquiv, EffectiveRate] = bndtotalreturn(价格、CouponRate解决、成熟度、ReinvestRate HorizonDate, 15 - 11 - 2021)

投资期限日期，指定为逗号分隔的对，由“HorizonDate”和一个标量或一个NINST——- - - - - -1.使用串行日期号、日期字符向量或日期时间数组的向量。

如果水平日期如果未指定，则总回报计算为成熟．

数据类型:双|字符|日期时间

在投资期限日的价格，指定为逗号分隔的对，由“水平价格”和一个标量或一个NINST——- - - - - -1.向量。

如果HorizonPrice是未指明的，价格在水平日期是根据再投资．如果水平日期等于成熟日期HorizonPrice忽略，并根据脸价值。

数据类型:双

每年的息票支付数量，指定为逗号分隔的一对，包括“时间”和一个标量或一个NINST——- - - - - -1.使用以下值的向量：0,1.,2.,3.,4.,6.,或12．

数据类型:双

日计数基础，指定为逗号分隔对，由“基础”和一个标量或一个NINST——- - - - - -1.向量。值为：

  • 0 =实际/实际

  • 1=30/360（新航）

  • 2 =实际/ 360

  • 3 =实际/ 365

  • 4 = 30/360 (psa)

  • 5=30/360（ISDA）

  • 6=30/360（欧洲）

  • 7 =实际/365(日文)

  • 8=实际/实际（ICMA）

  • 9 = actual/360 (ICMA)

  • 10=实际值/365（ICMA）

  • 11=30/360E（ICMA）

  • 12 =实际/365 (ISDA)

  • 13=公共汽车/252

有关更多信息，请参见基础．

数据类型:双

月结束规则标志，指定为逗号分隔对，由“EndMonthRule”和一个标量或一个NINST——- - - - - -1.向量。此规则仅适用于成熟是一个月只有30天或更少的月末日期。

  • 0=忽略规则，即债券息票支付日期总是当月的相同数字日。

  • 1.=设定规则，即债券息票支付日期总是当月的最后一天。

数据类型:必然的

债券发行日期，指定为逗号分隔对，由“IssueDate”和一个标量或一个NINST——- - - - - -1.使用串行日期号、日期字符向量或日期时间数组的向量。

如果未指定IssueDate，现金流支付日期由其他输入确定。

数据类型:双|字符|日期时间

不规则或正常的首次息票日期，指定为逗号分隔对，包括“FirstCouponDate”和一个标量或一个NINST——- - - - - -1.使用串行日期号、日期字符向量或日期时间数组的向量。

如果不指定a第一耦合，现金流支付日期由其他输入确定。

数据类型:双|字符|日期时间

不规则或正常的最后息票日期，指定为逗号分隔对，包括“LastCouponDate”和一个标量或一个NINST——- - - - - -1.使用串行日期号、日期字符向量或日期时间数组的向量。

如果不指定aLastCouponDate，现金流支付日期由其他输入确定。

数据类型:双|字符|日期时间

付款的远期起始日期，指定为逗号分隔的一对，包括“开始日期”和一个标量或一个NINST——- - - - - -1.使用串行日期号、日期字符向量或日期时间数组的向量。

如果不指定aStartDate可以，有效开始日期为解决日期。

数据类型:双|字符|日期时间

债券的面值，指定为由逗号分隔的对组成的“脸”和一个标量或一个NINST——- - - - - -1.向量。

数据类型:双

用于产量计算的复合频率，指定为逗号分隔对，包括“合成频率”和一个标量或一个NINST——- - - - - -1.向量。

  • 1.-年度复利

  • 2.-半年复利

  • 3.-一年三次复利

  • 4.-季度复合

  • 6.-双月复配

  • 12——每月复利

笔记

默认情况下，SIA碱基(0-7.),公共汽车/ 252使用半年一次的复合会议和ICMA基础(8.-12)使用年度复合约定。

数据类型:双

用于计算收益率的折扣因子的基础，指定为逗号分隔的对，由“折扣基础”和一个标量或一个NINST——- - - - - -1.向量。值为：

  • 0 =实际/实际

  • 1=30/360（新航）

  • 2 =实际/ 360

  • 3 =实际/ 365

  • 4 = 30/360 (psa)

  • 5=30/360（ISDA）

  • 6=30/360（欧洲）

  • 7 =实际/365(日文)

  • 8=实际/实际（ICMA）

  • 9 = actual/360 (ICMA)

  • 10=实际值/365（ICMA）

  • 11=30/360E（ICMA）

  • 12 =实际/365 (ISDA)

  • 13=公共汽车/252

有关更多信息，请参见基础．

笔记

默认行为适用于SIA基础(0-7.)使用实际的/实际的以日计数计算折扣因子，对于ICMA日计数(8.–12),公共汽车/ 252使用指定的贴现基础．

数据类型:双

输出参数

全部崩溃

以债券等价物为基础的总回报，作为纳邦兹——- - - - - -1.向量。

在有效利率基础上的总回报率，作为回报率纳邦兹——- - - - - -1.向量。

参考文献

法博齐，弗兰克·J，曼恩，史蒂文·V。固定收益分析导论:相对价值分析、风险度量和估值。约翰·威利父子公司，纽约，2010年。

另见

|||

话题

在R2012b中引入

财务工具箱文件

金宝app

用MATLAB建模财务风险的实用指南

用MATLAB建模财务风险的实用指南

下载电子书