Difference between revisions of "Manuals/calci/ODDLYIELD"

From ZCubes Wiki
Jump to navigation Jump to search
(Created page with "<div id="6SpaceContent" class="zcontent" align="left">  <font color="#000000"><font face="Arial, sans-serif">'''<font size="2">ODDLPRICE(settle, M, LI, R,pr, redem, F, bas...")
 
Line 1: Line 1:
<div id="6SpaceContent" class="zcontent" align="left"> 
+
<div style="font-size:30px">'''ODDLYIELD(s,m,lt,r,pr,rdm,f,b)'''</div><br/>
 +
*<math> s </math> is the settlement.
 +
*<math> m </math> is the maturity.
 +
*<math> lt </math> is the last coupon date.
 +
*<math> r </math> is the rate of interest.
 +
*<math> pr </math> is the security's price.
 +
*<math> rdm </math> is the security's redemption.
 +
*<math> f </math> is the frequency.
 +
*<math> b  </math> is the basis.
  
<font color="#000000"><font face="Arial, sans-serif">'''<font size="2">ODDLPRICE(settle, M, LI, R,pr, redem, F, basis)</font>'''</font></font>
+
==Description==
 
+
*This function gives  the yield of a security that pays interest periodically but has an odd last period.
<font color="#000000"><font face="Arial, sans-serif"><font size="2">'''Where 'settle''''</font><font size="2"> is the security's settlement date, 'M is the security's maturity date, 'LI' is the security's last coupon date, 'R' is the security's interest rate, 'pr' is the security's price, 'redem' is the security's redemption value, 'F' is the number of coupon payments per year, and 'basis' is the type of day count basis to use.</font></font></font>
+
*This function is the inverse function of the  OddLPrice function.
 
+
*In ODDLYIELD(s,m,lt,r,pr,rdm,f,b), s is the security's settlementDate. It  is a Date or DateTime specifying when the security was purchased.
</div>
+
*m is the security's maturity date. This date is after the settlement date specifying when the security matures.
----
+
*lt is the date which is specifying when the security has its last payment. This date must be before the settlementDate.
<div id="1SpaceContent" class="zcontent" align="left"> 
+
*r  is a non-negative number specifying the interest rate for the coupons that the security pays.
 
+
*pr  is a non-negative number or currency specifying the security’s purchase price per $100 of face value.
<font color="#000000"><font face="Arial, sans-serif"><font size="2">This function returns the yield of asecurity that has an odd last period.</font></font></font>
+
*rdm  is a number or currency specifying the security’s value at redemption per $100 of face value.
 
+
*f is  is a number specifying the number of coupons per year.  
</div>
+
*The supported values are
----
+
  1 -annual payments
<div id="7SpaceContent" class="zcontent" align="left"> 
+
  2 -semiannual payments
 
+
  4 -quarterly.
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">ODDLPRICE shows the error value, when 'settle', 'M', 'I', or 'FC' is not a valid date or 'R &lt;0' or 'pr&lt;=0'.</font></font></font>
+
*b is is an optional number specifying the day basis system to use.
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">Basis must between 0 and 4. </font></font></font>
+
*The following types are supported
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">M &gt; settle &gt; LI</font></font></font>
+
{| class="wikitable"
 
+
|-
</div>
+
! Basis
----
+
! Day count basis
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
+
|-
 
+
| 0 or omitted || American 30/360 (default)
ODDLYIELD
+
|-
 
+
| 1 || actual/actual
</div></div>
+
|-
----
+
| 2 || actual/360
<div id="8SpaceContent" class="zcontent" align="left">
+
|-
 
+
| 3 || actual/365
Consider an example in(Column2, Row3)
+
|-
 
+
| 4 || European 30/360
<nowiki>=ODDLYIELD(R1C1, R2C1, R3C1, R4C1, R5C1, R6C1, R1C2,R2C2)</nowiki>
 
 
 
The function returns 0.354477.
 
 
 
</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=" " |
 
| Column1
 
| class="  " | Column2
 
| Column3
 
| Column4
 
|- class="odd"
 
| class=" " | Row1
 
| class=" " | 1/1/2008
 
| class=" " | 2
 
| class=" " |
 
| class=" " |
 
|- class="even"
 
| class="  " | Row2
 
| class=" " | 5/1/2008
 
| class="sshl_f " | 0
 
| class=" " |
 
| class=" " |
 
|- class="odd"
 
| Row3
 
| class=" " | 11/15/2007
 
| class="sshl_f" | 0.354477
 
| class=" " |
 
| class=" " |
 
|- class="even"
 
| Row4
 
| class=" " | 3.75%
 
| 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>
 
| class=" " |
 
| class=" " |
 
|- class="odd"
 
| class=" " | Row5
 
| class=" " | 90.5
 
| class=" " |
 
| class=" " |
 
| class=" " |
 
|- class="even"
 
| Row6
 
| class=" " | 100
 
| class=" " |
 
| class=" " |
 
| class=" " |
 
 
|}
 
|}
 
+
 
<div align="left">[[Image:calci1.gif]]</div></div>
+
*ODDLYIELD is calculated as follows:
----
+
ODDLYIELD=
 +
*A_i = number of accrued days for the ith, or last, quasi-coupon period within odd period counting forward from last interest date before redemption.
 +
*DC_i = number of days counted in the ith, or last, quasi-coupon period as delimited by the length of the actual coupon period.
 +
*NC = number of quasi-coupon periods that fit in odd period; if this number contains a fraction it will be raised to the next whole number.
 +
*NLi = normal length in days of the ith, or last, quasi-coupon period within odd coupon period.
 +
*The date arguments must satisfy the following conditions:  
 +
        s(settlement) <lt(last interest) < m(maturity).
 +
*Also s, m, lt,and b are truncated in to integers.
 +
*This function gives the result as error when
 +
  1.The date arguments s,m and lt are not a valid date.
 +
  2.r<0 or pr<=0
 +
  3.b<0 or b>4

Revision as of 04:27, 28 February 2014

ODDLYIELD(s,m,lt,r,pr,rdm,f,b)


  • is the settlement.
  • is the maturity.
  • is the last coupon date.
  • is the rate of interest.
  • is the security's price.
  • is the security's redemption.
  • is the frequency.
  • is the basis.

Description

  • This function gives the yield of a security that pays interest periodically but has an odd last period.
  • This function is the inverse function of the OddLPrice function.
  • In ODDLYIELD(s,m,lt,r,pr,rdm,f,b), s is the security's settlementDate. It is a Date or DateTime specifying when the security was purchased.
  • m is the security's maturity date. This date is after the settlement date specifying when the security matures.
  • lt is the date which is specifying when the security has its last payment. This date must be before the settlementDate.
  • r is a non-negative number specifying the interest rate for the coupons that the security pays.
  • pr is a non-negative number or currency specifying the security’s purchase price per $100 of face value.
  • rdm is a number or currency specifying the security’s value at redemption per $100 of face value.
  • f is is a number specifying the number of coupons per year.
  • The supported values are
 1 -annual payments
 2 -semiannual payments
 4 -quarterly.
  • b is is an optional number specifying the day basis system to use.
  • The following types are supported
Basis Day count basis
0 or omitted American 30/360 (default)
1 actual/actual
2 actual/360
3 actual/365
4 European 30/360
  • ODDLYIELD is calculated as follows:

ODDLYIELD=

  • A_i = number of accrued days for the ith, or last, quasi-coupon period within odd period counting forward from last interest date before redemption.
  • DC_i = number of days counted in the ith, or last, quasi-coupon period as delimited by the length of the actual coupon period.
  • NC = number of quasi-coupon periods that fit in odd period; if this number contains a fraction it will be raised to the next whole number.
  • NLi = normal length in days of the ith, or last, quasi-coupon period within odd coupon period.
  • The date arguments must satisfy the following conditions:
       s(settlement) <lt(last interest) < m(maturity). 
  • Also s, m, lt,and b are truncated in to integers.
  • This function gives the result as error when
  1.The date arguments s,m and lt are not a valid date.
  2.r<0 or pr<=0
  3.b<0 or b>4