Difference between revisions of "Manuals/calci/ACCRINT"

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">'''ACCRINT'''</font></font><font face="Arial, s...")
 
Line 1: Line 1:
<div id="6SpaceContent" class="zcontent" align="left"> 
+
=ACCRINT(issue, FI, settlement, rate, par, frequency, basis, method)=
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">'''ACCRINT'''</font></font><font face="Arial, sans-serif"><font size="2">(</font></font><font face="Arial, sans-serif"><font size="2">'''I'''</font></font><font face="Arial, sans-serif"><font size="2">, </font></font><font face="Arial, sans-serif"><font size="2">'''FI'''</font></font><font face="Arial, sans-serif"><font size="2">, </font></font><font face="Arial, sans-serif"><font size="2">'''settle'''</font></font><font face="Arial, sans-serif"><font size="2">, </font></font><font face="Arial, sans-serif"><font size="2">'''R'''</font></font><font face="Arial, sans-serif"><font size="2">, par, </font></font><font face="Arial, sans-serif"><font size="2">'''F'''</font></font><font face="Arial, sans-serif"><font size="2">, basis)</font></font></font>
+
*where, <math>issue</math> is the security's issue date (a date when coupon or a bond is issued)
 +
*<math>FI</math> is the first interest date
 +
*<math>settlement</math> is the security's settlement date (a date when coupon or a bond is purchased)
 +
*<math>rate</math> is the security's annual coupon rate
 +
*<math>par</math> is the security's par value
 +
*<math>frequency</math> is the number of coupon payments per year
 +
*<math>basis</math> is the type of day count basis to use
 +
*<math>method</math> a logical value that specifies how to calculate total accrued interest when settlement is later than first interest date.
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">Where 'I' is the security's issue date, 'FI' is the first interest date, 'settle' is the security's settlement date, 'R' is the security's annual coupon rate, 'par' is the security's par value, 'F' is the number of coupon payments per year and 'basis' is the type of day count basis to use.</font></font></font>
+
ACCRINT() calculates the accrued interest for the security that pays periodic interest.
  
</div>
+
== Description ==
----
 
<div id="1SpaceContent" class="zcontent" align="left"> <font color="#000000"><font face="Arial, sans-serif"><font size="2">This function shows the accrued interest for a security that pays periodic interest.</font></font></font></div>
 
----
 
<div id="7SpaceContent" class="zcontent" align="left"> 
 
  
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">I, FI, Settle should be valid in this function and 'F' should be 1, 2, or 4.</font></font></font>
+
ACCRINT(issue, FI, settlement, rate, par, frequency, basis, method)
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">Whenever rate ≤ 0 or if par ≤ 0, ACCRINT shows NAN(error) value. </font></font></font>
 
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">Basis must be between 0 and 4</font></font></font>
 
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">ACCRINT is calculated as follows: </font></font></font>
 
  
<font color="#000000"></font>
+
*Accrued interest is the interest accumulated on a bond since the last interest payment up to, but not including, the settlement date.
 +
*<math>settlement</math> is the date after issue date when security or bond is purchased by customer.
 +
*<math>issue</math>, <math>FI</math> and <math>settlement</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>issue</math> &gt;= <math>settlement</math>, Calci displays #NUM error message.
 +
*If <math>par</math> is omitted, Calci assumes value as $1,000.
 +
*If <math>rate</math> &lt;=0 or <math>par</math> &lt;=0, Calci displays #NUM error message.
 +
*The values for 'frequency' should be 1,2 or 4.
 +
For Annual payment, frequency = 1,
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">where:</font></font></font>
+
For Semi-annual payment, frequency = 2,
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">Ai = number of accrued days for the ith quasi-coupon period within odd period.</font></font></font>
+
For Quarterly payment, frequency = 4.
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">NC = number of quasi-coupon periods that fit in odd period. If this number contains a fraction, raise it to the next whole number.</font></font></font>
 
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">NLi = normal length in days of the ith quasi-coupon period within odd period.</font></font></font>
+
*'basis' value is optional. If omitted, Calci assumes it to be 0.
 +
Below table shows the use of 'basis' values:
  
</div>
+
{| class="wikitable"
----
+
|-
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
+
! Basis !! Description
 +
|-
 +
| 0 || US (NASD) 30/360
 +
|-
 +
| 1 || Actual/actual
 +
|-
 +
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/365
 +
|}
  
ACCRINT
+
*If 'basis' value is other than 0 to 4, Calci displays #N/A error message.
 +
*<math>method</math> can be TRUE or FALSE. If omitted, Calci assumes it to be TRUE.
 +
*If <math>method</math> = TRUE, it calculates total accrued interest from issue to settlement.
 +
*If <math>method</math> = FALSE, it calculates total accrued interest from first interest to settlement.
  
</div></div>
+
== Examples ==
----
 
<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>
+
Consider the following example that shows the use of DURATION function:
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">ACCRINT(I, FI, settle, R, par, F, basis)</font></font></font>
+
<div id="2SpaceContent" class="zcontent" align="left">
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">B</font></font></font>
+
{| id="TABLE3" class="SpreadSheet blue"
 +
|- class="even"
 +
| class="sshl_f" | 4/1/2010
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">April 1, 2010</font></font></font>
+
|- class="odd"
 +
| class="sshl_f" | 10/31/2010
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">August 31, 2010</font></font></font>
+
|- class="even"
 +
| class="sshl_f" | 6/1/2010
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">June 1, 2010</font></font></font>
+
|- class="odd"
 +
| class="sshl_f" | 20%
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">20%</font></font></font>
+
|- class="even"
 +
| class="sshl_f" | 500
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">500</font></font></font>
+
|- class="odd"
 +
| class="sshl_f" | 2
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">3</font></font></font>
+
|- class="even"
 +
| class="sshl_f" | 0
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">0</font></font></font>
+
|- class="odd"
 +
| class=" " |
 +
| class=" " |
 +
| class=" " |
 +
|}
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2"><nowiki>=ACCRINT(B2,B3,B4,B5,B6,B7,B8) is 16.667</nowiki></font></font></font>
+
=DURATION(A1,A2,A3,A4,A5,A6,A7) ''displays 16.667'' as a result.
 +
=DURATION(DATE(2010,3,5),A2,A3,A4,A5,A6,A7,FALSE) ''displays 23.889'' as a result.
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2"><nowiki>=ACCRINT(DATE(2010,3,5),B3,B4,B5,B6,B7,B8) is 23.889</nowiki></font></font></font>
+
== See Also ==
  
</div>
+
*[[Manuals/calci/DURATION | DURATION]]
----
 
<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"
+
== References ==
|- class="even"
 
| class=" " |
 
| class="  " | Column1
 
| class="    " | Column2
 
| Column3
 
| class="sshl_f" | Column4
 
|- class="odd"
 
| class=" " | Row1
 
| class=" " | April 1, 2010
 
| class="sshl_f" |
 
| class="                                                                sshl_f  " |
 
|
 
|- class="even"
 
| class="  " | Row2
 
| class=" " | August 31, 2010
 
| class="sshl_f" | 16.666667
 
|
 
|
 
|- class="odd"
 
| Row3
 
| class=" " | June 1, 2010
 
| class="sshl_f" | 23.888889
 
|
 
|
 
|- class="even"
 
| Row4
 
| class=" " | 20%
 
| class="SelectTd" |
 
|
 
|
 
|- class="odd"
 
| class=" " | Row5
 
| class=" " | 500
 
| class="                                                                    sshl_t ChangeBGColor" |
 
| class=" sshl_f" |
 
|
 
|- class="even"
 
| class="sshl_f" | Row6
 
| class=" " | 3
 
| class="sshl_t" |
 
| class=" sshl_f" |
 
|
 
|- class="odd"
 
| class="sshl_f" | Row7
 
| class="sshl_f " | 0
 
| class="sshl_t" |
 
| class=" sshl_f" |
 
|
 
|}
 
  
<div align="left">[[Image:calci1.gif]]</div></div>
+
*[http://en.wikipedia.org/wiki/Accrued_interest Accrued Interest]
----
+
*[http://en.wikipedia.org/wiki/Day_count_convention Day Count Basis]

Revision as of 17:40, 2 January 2014

ACCRINT(issue, FI, settlement, rate, par, frequency, basis, method)

  • where, is the security's issue date (a date when coupon or a bond is issued)
  • is the first interest date
  • is the security's settlement date (a date when coupon or a bond is purchased)
  • is the security's annual coupon rate
  • is the security's par value
  • is the number of coupon payments per year
  • is the type of day count basis to use
  • a logical value that specifies how to calculate total accrued interest when settlement is later than first interest date.

ACCRINT() calculates the accrued interest for the security that pays periodic interest.

Description

ACCRINT(issue, FI, settlement, rate, par, frequency, basis, method)

  • Accrued interest is the interest accumulated on a bond since the last interest payment up to, but not including, the settlement date.
  • is the date after issue date when security or bond is purchased by customer.
  • , 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 >= , Calci displays #NUM error message.
  • If is omitted, Calci assumes value as $1,000.
  • If <=0 or <=0, Calci displays #NUM error message.
  • The values for 'frequency' should be 1,2 or 4.

For Annual payment, frequency = 1,

For Semi-annual payment, frequency = 2,

For Quarterly payment, frequency = 4.


  • 'basis' value is optional. If omitted, Calci assumes it to be 0.

Below table shows the use of 'basis' values:

Basis Description
0 US (NASD) 30/360
1 Actual/actual
2 Actual/360
3 Actual/365
4 European 30/365
  • If 'basis' value is other than 0 to 4, Calci displays #N/A error message.
  • can be TRUE or FALSE. If omitted, Calci assumes it to be TRUE.
  • If = TRUE, it calculates total accrued interest from issue to settlement.
  • If = FALSE, it calculates total accrued interest from first interest to settlement.

Examples

Consider the following example that shows the use of DURATION function:

4/1/2010
10/31/2010
6/1/2010
20%
500
2
0
=DURATION(A1,A2,A3,A4,A5,A6,A7) displays 16.667 as a result.
=DURATION(DATE(2010,3,5),A2,A3,A4,A5,A6,A7,FALSE) displays 23.889 as a result.

See Also

References