Difference between revisions of "Manuals/calci/YIELDDISC"

From ZCubes Wiki
Jump to navigation Jump to search
(Created page with "<div id="6SpaceContent" class="zcontent" align="left"> '''YIELDDISC'''(SettlementDate, MaturityDate, Price, Redemption, Basis) where, '''SettlementDate''' - represe...")
 
Line 1: Line 1:
<div id="6SpaceContent" class="zcontent" align="left">
+
=YIELDDISC(settlement, maturity, price, redemption, basis)=
  
'''YIELDDISC'''(SettlementDate, MaturityDate, Price, Redemption, 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>price</math> is the price per $100 face value,
 +
*<math>redemption</math> is security's redemption value per &#36;100 face value,
 +
*<math>basis</math> is the type of day count basis to use.
  
where,
+
YIELDDISC() calculates the annual yield on discounted security or a bond.
  
'''SettlementDate''' - represents the settlement date.
+
== Description ==
  
'''MaturityDate''' - represents the maturity date.
+
YIELDDISC(settlement, maturity, price, redemption, basis)
  
'''Price''' - represents the price per $100 face value.
+
*YIELDDISC referred to as 'Discount Yield' is the measure of security's percentage return.
  
'''Redemption''' - is the redemption value per $100 face value.
+
Formula:-
  
'''Basis''' - type of day count basis
+
<math>Discount Yield = \frac{(par value - price)}{par value} * \frac{360}{days to maturity}</math>
  
'''Basis              Day count basis'''
+
*<math>settlement</math> and <math>maturity</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.
 +
*If <math>settlement</math> date = <math>maturity</math> date, Calci displays #N/A error message.
 +
*<math>price</math> and <math>redemption</math> values 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:
  
0 or omitted    US 30/360
+
{| class="wikitable"
 +
|-
 +
! Basis !! Description
 +
|-
 +
| 0 || US (NASD) 30/360
 +
|-
 +
| 1 || Actual/actual
 +
|-
 +
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/360
 +
|}
  
1                     Actual/actual
+
*If <math>basis</math> value is other than 0 to 4, Calci displays #N/A error message.
  
2                     Actual/360
+
== Examples ==
  
3                     Actual/365
+
YIELDDISC(settlement, maturity, price, redemption, basis) function with inputs in order is calculated as follows:
  
4                     European 30/360
+
<div id="2SpaceContent" class="zcontent" align="left">
  
</div>
+
{| id="TABLE3" class="SpreadSheet blue"
----
+
|- class="even"
<div id="1SpaceContent" class="zcontent" align="left">
+
| class="sshl_f" | 1/1/2008
 +
| class="sshl_f" |
  
It returns the annual yield for discounted.
+
|- class="odd"
 +
| class="sshl_f" | 20/2/2008
 +
| class="sshl_f" |
  
</div>
+
|- class="even"
----
+
| class="sshl_f" | 95.58
<div id="7SpaceContent" class="zcontent" align="left">
+
| class="sshl_f" |
  
If Basis &lt; 0 or Basis &gt; 4 , YIELDDISC returns the #ERROR.
+
|- class="odd"
 +
| class="sshl_f" | $100
 +
| class="sshl_f" |
  
If  Price &lt;= 0 or Redemption &lt;=0, it returns the #ERROR.
+
|- class="even"
 +
| class="sshl_f" | 2
 +
| class="sshl_f" |
  
If SettlementDate &gt;= MaturityDate, YIELDDISC returns #ERROR.
+
|}
 
 
</div>
 
----
 
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
 
 
 
YIELDDISC
 
 
 
</div></div>
 
----
 
<div id="8SpaceContent" class="zcontent" align="left">
 
 
 
Lets see an example in (Column1, Row6)
 
  
<nowiki>=YIELDDISC(R1C1, R2C1, R3C1, R4C1, R5C1)</nowiki>
+
=YIELDDISC(A1,A2,A3,A4,A5) : Calculates the discount yield Value with the inputs in the range A1 to A5. Returns '''33.3%''' as a result.
 +
=YIELDDISC(DATE(2007,1,1), DATE(2008,2,20), 85.12, 100) : Calculates the discount yield Value with the inputs. Returns '''15.39%''' as a result.
  
YIELDDISC returns 5.7543.
+
== See Also ==
  
Consider another example
+
*[[Manuals/calci/YIELD | YIELD]]
 +
*[[Manuals/calci/YIELDMAT | YIELDMAT]]
  
<nowiki>=YIELDDISC(date(2007,1,1), date(2008,2,20), 85.12, 100,5)</nowiki>
+
== References ==
 
 
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">
 
 
 
{| id="TABLE3" class="SpreadSheet blue"
 
|- class="even"
 
| class=" " |
 
| class="  " | Column1
 
| Column2
 
| Column3
 
| Column4
 
|- class="odd"
 
| class=" " | Row1
 
| class=" " | 1/1/2008
 
| 0
 
| 0
 
| 0
 
|- class="even"
 
| class="  " | Row2
 
| class=" " | 2/20/2008
 
| 0
 
| 0
 
| 0
 
|- class="odd"
 
| Row3
 
| class=" " | 55.58
 
| 0
 
| 0
 
| 0
 
|- class="even"
 
| Row4
 
| class=" " | 100
 
| 0
 
| 0
 
| 0
 
|- class="odd"
 
| class=" " | Row5
 
| class="sshl_f " | 2
 
| 0
 
| 0
 
| 0
 
|- class="even"
 
| class="sshl_f" | Row6
 
| class="sshl_f" | 5.7543
 
| class="sshl_f" |
 
| class="sshl_f" |
 
| class="sshl_f" |
 
|- class="odd"
 
| class="sshl_f" | Row7
 
| 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>
 
| 0
 
| 0
 
| 0
 
|}
 
  
<div align="left">[[Image:calci1.gif]]</div></div>
+
*[http://en.wikipedia.org/wiki/Yield_(finance) Yield]
----
+
*[http://en.wikipedia.org/wiki/Discounting Discount Yield]
 +
*[http://en.wikipedia.org/wiki/Day_count_convention Basis Convention]

Revision as of 07:24, 4 February 2014

YIELDDISC(settlement, maturity, price, redemption, basis)

  • where is security's settlement date (a date when coupon or a bond is purchased),
  • is security's maturity date (a date when coupon or a bond expires),
  • is the price per $100 face value,
  • is security's redemption value per $100 face value,
  • is the type of day count basis to use.

YIELDDISC() calculates the annual yield on discounted security or a bond.

Description

YIELDDISC(settlement, maturity, price, redemption, basis)

  • YIELDDISC referred to as 'Discount Yield' is the measure of security's percentage return.

Formula:-


  • and dates should be entered either in 'date format' or 'dates returned using formulas'. If dates are not valid, Calci displays #N/A error message.
  • If date = date, Calci displays #N/A error message.
  • and values must be greater than zero, else Calci displays #N/A error message.
  • value is optional. If omitted, Calci assumes it to be 0.

Below table shows the use of values:

Basis Description
0 US (NASD) 30/360
1 Actual/actual
2 Actual/360
3 Actual/365
4 European 30/360
  • If value is other than 0 to 4, Calci displays #N/A error message.

Examples

YIELDDISC(settlement, maturity, price, redemption, basis) function with inputs in order is calculated as follows:

1/1/2008
20/2/2008
95.58
$100
2
=YIELDDISC(A1,A2,A3,A4,A5) : Calculates the discount yield Value with the inputs in the range A1 to A5. Returns 33.3% as a result.
=YIELDDISC(DATE(2007,1,1), DATE(2008,2,20), 85.12, 100) : Calculates the discount yield Value with the inputs. Returns 15.39% as a result.

See Also

References