Difference between revisions of "Manuals/calci/ODDFYIELD"

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">ODDFYIELD(settle, M, I, FC, R, P, redem, F, basi...")
 
Line 1: Line 1:
<div id="6SpaceContent" class="zcontent" align="left"> <font color="#000000">'''<font face="Arial, sans-serif"><font size="2">ODDFYIELD(settle, M, I, FC, R, P, redem, F, basis)</font></font>'''</font>
+
<div style="font-size:30px">'''ODDFYIELD(s,m,iss,fc,r,pr,rdm,f,b)'''</div><br/>
 +
*<math> s </math> is the settlement.
 +
*<math> m </math> is the maturity.
 +
*<math> iss </math> is the issue date.
 +
*<math> fc </math> is the first 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">'''Where 'settle''''</font></font><font face="Arial, sans-serif"><font size="2"> is the security's settlement date, 'M' is the security's maturity date, 'I' is the security's issue date, 'FC' is the security's first coupon date, 'R' is the security's interest rate, 'P' is the security's price, 'redem' is the security's redemption value, 'F' is the number of coupon payments per year ans 'basis' is the type of day count basis to use.</font></font></font>
+
==Description==
 
+
*This function gives  the yield of a security that pays interest periodically but has an odd first period.
</div>
+
*<math> ODDFYIELD(s,m,iss,fc,r,pr,rdm,f,b)</math>,<math> s </math> is the security's settlementDate. It  is a Date or DateTime specifying when the security was purchased.
----
+
*<math> m </math> is the security's maturity date. This date is after the settlement date specifying when the security matures.
<div id="1SpaceContent" class="zcontent" align="left"> <font color="#000000"><font face="Arial, sans-serif"><font size="2">This function computes the yield of a security that has an odd first period.</font></font></font></div>
+
*<math> iss </math> is the date which is specifying when the security was issued.
----
+
*<math> fc </math> is the date which is specifying when the security has its first interest payment. This date must be after the settlement date but before the maturity date.
<div id="7SpaceContent" class="zcontent" align="left"> 
+
*<math> r </math> is a non-negative number specifying the interest rate for the coupons that the security pays.
 
+
*<math> pr </math> 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">ODDFYIELD shows the error value, when 'settle', 'M', 'I', or 'FC' is not a valid date or 'R' or 'Yield' &lt; 0.</font></font></font>
+
*<math> rdm </math> is a number or currency specifying the security’s value at redemption per $100 of face value.
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">Basis must be between 0 and 4. </font></font></font>
+
*<math> f </math> is  is a number specifying the number of coupons per year.
 
+
*The supported values are
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">M &gt;FC &gt; settle &gt; I</font></font></font>
+
  1 -annual payments
 +
  2 -semiannual payments
 +
  4 -quarterly.
 +
*<math> b </math> is an optional number specifying the day basis system to use.  
 +
*The following types are supported
 +
{| class="wikitable"
 +
|-
 +
! Basis
 +
! Day count basis
 +
|-
 +
| 0 or omitted || American 30/360 (default)
 +
|-
 +
| 1 || actual/actual
 +
|-
 +
| 2 || actual/360
 +
|-
 +
| 3 || actual/365
 +
|-
 +
| 4 || European 30/360
 +
|}
  
<br /><br />
+
*To find the value of a <math> ODDFYIELD</math> we are using the iterative technique.
 +
*The value is changed through 100 iterations until the estimated price with the given value is near to the price.
 +
*The date arguments must satisfy the following conditions:
 +
    iss(issue)<s(settlement) <fc(first coupon) < m(maturity).
 +
*Also <math> s </math>, <math> m </math>,<math> iss </math>,<math> fc </math> and <math> b </math> are truncated in to integers.
 +
*This function gives the result as error when
 +
  1.The date arguments s,m and fc are not a valid date.
 +
  2.r<0 or pr<=0
 +
  3.b<0 or b>4
  
</div>
+
==Examples==
----
 
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
 
 
 
ODDFYIELD
 
 
 
</div></div>
 
----
 
<div id="8SpaceContent" class="zcontent" align="left"> <font color="#000000"><font face="Arial, sans-serif"><font size="2">'''Lets see an example,'''</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">ODDFYIELD(settle, M, I, FC, R, P, redem, F, basis)</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">'''B'''</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">10-15- 2010</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">01-10-2023</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">09-15-2010</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">01-10-2011</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">4.35%</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">75</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">100</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">2</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">0</font></font></font>
 
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2"><nowiki>=ODDFYIELD(B2,B3,B4,B5,B6,B7,B8,B9,B10) is 0.0751</nowiki></font></font></font>
 
 
 
</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="5SpaceContent" class="zcontent" align="left">
 
 
 
{| id="TABLE1" class="SpreadSheet blue"
 
|- class="even"
 
| class=" " |
 
| class="  " | Column1
 
| class="        " | Column2
 
| Column3
 
| Column4
 
|- class="odd"
 
| class=" " | Row1
 
| class="sshl_f" | 10-15- 2010
 
| class="sshl_f" | 0.0751
 
| class="                                " |
 
| class="SelectTD                                sshl_t ChangeBGColor" |
 
|- class="even"
 
| class="  " | Row2
 
| class="sshl_f" | 01-10-2023
 
| class="sshl_f  " |
 
| class=" " |
 
| class=" sshl_t" |
 
|- class="odd"
 
| Row3
 
| class="sshl_f" | 09-15-2010
 
| class="    sshl_f  " |
 
| class=" " |
 
| class=" sshl_t" |
 
|- class="even"
 
| Row4
 
| class="sshl_f" | 01-10-2011
 
| class=" " |
 
| class=" " |
 
| class=" sshl_t" |
 
|- class="odd"
 
| class=" " | Row5
 
| class="sshl_f" | 4.35%
 
| class=" " |
 
| class=" " |
 
| class=" sshl_t" |
 
|- class="even"
 
| class="sshl_f" | Row6
 
| class="sshl_f" | 75
 
| class=" " |
 
| class=" " |
 
| class="    " |
 
|- class="odd"
 
| class="sshl_f" | Row7
 
| class="sshl_f  " | 100
 
| class="sshl_f" |
 
| class=" " |
 
| class=" " |
 
|- class="even"
 
| class="sshl_f" | Row8
 
| class="sshl_f" | 2
 
| class="sshl_f" |
 
| class=" " |
 
| class=" " |
 
|- class="odd"
 
| class="sshl_f" | Row9
 
| class="sshl_f" | 0
 
| class="                                                                                                                      " |
 
| class=" " |
 
| class=" " |
 
|}
 
  
<div align="left">[[Image:calci1.gif]]</div></div>
+
==See Also==
----
+
==References==

Revision as of 23:38, 2 March 2014

ODDFYIELD(s,m,iss,fc,r,pr,rdm,f,b)


  • is the settlement.
  • is the maturity.
  • is the issue date.
  • is the first 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 first period.
  • , is the security's settlementDate. It is a Date or DateTime specifying when the security was purchased.
  • is the security's maturity date. This date is after the settlement date specifying when the security matures.
  • is the date which is specifying when the security was issued.
  • is the date which is specifying when the security has its first interest payment. This date must be after the settlement date but before the maturity date.
  • is a non-negative number specifying the interest rate for the coupons that the security pays.
  • is a non-negative number or currency specifying the security’s purchase price per $100 of face value.
  • is a number or currency specifying the security’s value at redemption per $100 of face value.
  • is is a number specifying the number of coupons per year.
  • The supported values are
 1 -annual payments
 2 -semiannual payments
 4 -quarterly.
  • 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
  • To find the value of a we are using the iterative technique.
  • The value is changed through 100 iterations until the estimated price with the given value is near to the price.
  • The date arguments must satisfy the following conditions:
   iss(issue)<s(settlement) <fc(first coupon) < m(maturity). 
  • Also , ,, and are truncated in to integers.
  • This function gives the result as error when
  1.The date arguments s,m and fc are not a valid date.
  2.r<0 or pr<=0
  3.b<0 or b>4

Examples

See Also

References