ZCubes Wiki

Changes

Manuals/calci/YIELDMAT (view source)

Revision as of 22:10, 3 February 2014

427 bytes removed ,  22:10, 3 February 2014
no edit summary
Line 1: Line 1: −
<div id="6SpaceContent" class="zcontent" align="left">
+
=YIELDMAT(settlement, maturity, issue, rate, price, basis)=
   −
'''YIELDMAT'''(SettlementDate, MaturityDate, IssueDate, Rate, Price, Basis)
+
*where <math>settlement</math> is security's settlement date (a date when coupon or a bond is purchased),
 +
*<math>maturity</math> is security's maturity date (a date when coupon or a bond expires),
 +
*<math>issue</math> is security's issue date (a date when coupon or a bond is issued),
 +
*<math>rate</math> is security's annual coupon rate,  
 +
*<math>price</math> is the price per $100 face value,
 +
*<math>basis</math> is the type of day count basis to use.
   −
where,
+
YIELDMAT() calculates the annual yield on a security or a bond that pays interest at maturity.
   −
'''SettlementDate''' - represents the settlement date.
+
== Description ==
   −
'''MaturityDate''' - represents the maturity date.
+
YIELDMAT(settlement, maturity, issue, rate, price, basis)
   −
'''IssueDate -''' represents the issue date.
+
*YIELDMAT is the percentage annual yield on security that pays interest at maturity.
 +
*<math>settlement</math>, <math>maturity</math> and <math>issue</math> dates should be entered either in 'date format' or 'dates returned using formulas'. If dates are not valid, Calci displays #N/A error message.
 +
*Dates should satisfy the following condition. <math>maturity</math> &gt; <math>settlement</math> &gt; <math>issue</math>, else Calci displays #N/A error message.
 +
*<math>rate</math> value must be greater than or equal to zero, else Calci displays #N/A error message.
 +
*<math>price</math> value must be greater than zero, else Calci displays #N/A error message.
 +
*<math>basis</math> value is optional. If omitted, Calci assumes it to be 0.  
 +
Below table shows the use of <math>basis</math> values:
   −
'''Rate''' - represents the  rate.
+
{| class="wikitable"
−
 
+
|-
−
'''Price''' - represents the price per $100 face value.
+
! Basis !! Description
−
 
+
|-
−
'''Basis''' - type of day count basis
+
| 0 || US (NASD) 30/360
−
 
+
|-
−
'''Basis              Day count basis'''
+
| 1 || Actual/actual
−
 
+
|-
−
0 or omitted    US 30/360
+
| 2 || Actual/360
−
 
+
|-
−
1                     Actual/actual
+
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/360
 +
|}
   −
2                     Actual/360
+
*If <math>basis</math> value is other than 0 to 4, Calci displays #N/A error message.
   −
3                     Actual/365
+
== Examples ==
   −
4                     European 30/360
+
YIELDMAT(settlement, maturity, issue, rate, price, basis) function with inputs in order is calculated as follows:
   −
</div>
  −
----
  −
<div id="1SpaceContent" class="zcontent" align="left">
  −
  −
It returns the annual yield that pays interest at maturity.
  −
  −
</div>
  −
----
  −
<div id="7SpaceContent" class="zcontent" align="left">
  −
  −
If Basis &lt; 0 or Basis &gt; 4 , YIELDMAT returns the #ERROR.
  −
  −
If  Rate &lt; 0 or Price &lt;= 0, it returns the #ERROR.
  −
  −
If SettlementDate &gt;= MaturityDate, YIELDMAT returns #ERROR.
  −
  −
</div>
  −
----
  −
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
  −
  −
YIELDMAT
  −
  −
</div></div>
  −
----
  −
<div id="8SpaceContent" class="zcontent" align="left">
  −
  −
Lets see an example in (Column1, Row6)
  −
  −
<nowiki>=YIELDMAT(R1C1, R2C1, R3C1, R4C1, R5C1)</nowiki>
  −
  −
YIELDMAT returns 1.651036.
  −
  −
Consider another example
  −
  −
<nowiki>=YIELDMATdate(2007,1,1), date(2008,2,20),DATE(2007,5,5),"6.34%" 85.12,5)</nowiki>
  −
  −
It returns #ERROR(Basis=5).
  −
  −
</div>
  −
----
  −
<div id="10SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Syntax </div><div class="ZEditBox"><center></center></div></div>
  −
----
  −
<div id="4SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Remarks </div></div>
  −
----
  −
<div id="3SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Examples </div></div>
  −
----
  −
<div id="11SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Description </div></div>
  −
----
   
<div id="2SpaceContent" class="zcontent" align="left">
 
<div id="2SpaceContent" class="zcontent" align="left">
    
{| id="TABLE3" class="SpreadSheet blue"
 
{| id="TABLE3" class="SpreadSheet blue"
 
|- class="even"
 
|- class="even"
−
| class=" " |
+
| class="sshl_f" | 1/2/2010
−
| class="   " | Column1
+
| class="sshl_f" |
−
| class=" SelectTD ChangeBGColor SelectTD" |
+
 
−
<div id="2Space_Handle" class="zhandles" title="Click and Drag to resize CALCI Column/Row/Cell. It is EZ!"></div><div id="2Space_Copy" class="zhandles" title="Click and Drag over to AutoFill other cells."></div><div id="2Space_Drag" class="zhandles" title="Click and Drag to Move/Copy Area.">[[Image:copy-cube.gif]]  </div>Column2
  −
| Column3
  −
| Column4
   
|- class="odd"
 
|- class="odd"
−
| class=" " | Row1
+
| class="sshl_f" | 1/2/2012
−
| class=" " | 1/1/2008
+
| class="sshl_f" |  
−
|
+
 
−
|
  −
|
   
|- class="even"
 
|- class="even"
−
| class=" " | Row2
+
| class="sshl_f" | 12/1/2009
−
| class=" " | 2/20/2008
+
| class="sshl_f" |
−
|
+
 
−
|
  −
|
   
|- class="odd"
 
|- class="odd"
−
| Row3
+
| class="sshl_f" | 5.5%
−
| class=" " | 2/2/2007
+
| class="sshl_f" |  
−
|
+
 
−
|
  −
|
   
|- class="even"
 
|- class="even"
−
| Row4
+
| class="sshl_f" | $100
−
| class=" " | 8.25%
+
| class="sshl_f" |
−
|
+
 
−
|
  −
|
   
|- class="odd"
 
|- class="odd"
−
| class=" " | Row5
+
| class="sshl_f" | 0
−
| class=" " | 80.855
  −
|
  −
|
  −
|
  −
|- class="even"
  −
| class="sshl_f" | Row6
  −
| class="sshl_f " | 2
   
| class="sshl_f" |
 
| class="sshl_f" |
−
| class="sshl_f" |
  −
| class="sshl_f" |
  −
|- class="odd"
  −
| class="sshl_f" | Row7
  −
| class="sshl_f" | 1.651036
  −
|
  −
|
  −
|
   
|}
 
|}
   −
<div align="left">[[Image:calci1.gif]]</div></div>
+
=YIELDMAT(A1,A2,A3,A4,A5,A6) : Calculates the percentage annual yield with the inputs in the range A1 to A7. Returns '''5.47%''' as a result.
−
----
+
 
 +
== See Also ==
 +
 
 +
*[[Manuals/calci/YIELD| YIELD]]
 +
*[[Manuals/calci/YIELDDISC | YIELDDISC]]
 +
 
 +
== References ==
 +
 
 +
*[http://en.wikipedia.org/wiki/Yield_(finance) Yield]
 +
*[http://en.wikipedia.org/wiki/Yield_to_maturity Yield to Maturity]
 +
*[http://en.wikipedia.org/wiki/Day_count_convention Basis Convention]
Swapna
writer
2,661

edits

Retrieved from "http://wiki.zcubes.com/Special:MobileDiff/197585"