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...")
 
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div id="6SpaceContent" class="zcontent" align="left"> 
+
<div style="font-size:25px">'''ACCRINT (Issue,FirstInterest,Settlement,Rate,Par,Frequency,Basis)'''</div><br/>
  
<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>FirstInterest</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
 +
**ACCRINT() returns the accrued interest for a security that pays periodic interest.
  
<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>
+
== Description ==
  
</div>
+
ACCRINT (Issue,FirstInterest,Settlement,Rate,Par,Frequency,Basis)
----
 
<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>
+
*Accrued interest is the interest accumulated on a bond since the last interest payment up to, but not including, the settlement date.
* <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>
+
*<math>Settlement</math> is the date after issue date when security or bond is purchased by customer.
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">Basis must be between 0 and 4</font></font></font>
+
*<math>Issue</math>, <math>FirstInterest</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.
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">ACCRINT is calculated as follows: </font></font></font>
+
*If <math>Issue</math> &gt;= <math>settlement</math>, Calci displays #N/A error message.
 +
*If <math>Par</math> is omitted, Calci displays #N/A error message.
 +
*If <math>Rate</math> &lt;=0 or <math>Par</math> &lt;=0, Calci displays #N/A error message.
 +
*The values for <math>Frequency</math> should be 1,2 or 4.
 +
For Annual payment, Frequency = 1,
  
<font color="#000000"></font>
+
For Semi-annual payment, Frequency = 2,
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">where:</font></font></font>
+
For Quarterly payment, Frequency = 4.
  
<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>
+
*<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0.
 +
Below table shows the use of <math>Basis</math> values:
  
<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>
+
{| class="wikitable"
 +
|-
 +
! Basis !! Description
 +
|-
 +
| 0 || US (NASD) 30/360
 +
|-
 +
| 1 || Actual/actual
 +
|-
 +
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/365
 +
|}
  
<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>
+
*If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message.
  
</div>
 
----
 
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
 
  
ACCRINT
+
== Examples ==
  
</div></div>
+
Consider the following example that shows the use of ACCRINT function:
----
+
 
<div id="8SpaceContent" class="zcontent" align="left"> 
+
<div id="2SpaceContent" class="zcontent" align="left">
 +
 
 +
{| 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">Lets see an example,</font></font></font>
+
|- class="odd"
 +
| class="sshl_f" | 10/31/2010
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">ACCRINT(I, FI, settle, R, par, F, basis)</font></font></font>
+
|- class="even"
 +
| class="sshl_f" | 6/1/2010
 +
| class=" " |
 +
| class=" " |
 +
 
 +
|- class="odd"
 +
| class="sshl_f" | 20%
 +
| class=" " |
 +
| class=" " |
 +
 
 +
|- class="even"
 +
| class="sshl_f" | 500
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">B</font></font></font>
+
|- class="odd"
 +
| class="sshl_f" | 2
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">April 1, 2010</font></font></font>
+
|- class="even"
 +
| class="sshl_f" | 0
 +
| class=" " |
 +
| class=" " |
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">August 31, 2010</font></font></font>
+
|- class="odd"
 +
| class=" " |
 +
| class=" " |
 +
| class=" " |
 +
|}
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">June 1, 2010</font></font></font>
+
=ACCRINT(A1,A2,A3,A4,A5,A6,A7) ''displays 16.667'' as a result.
 +
=ACCRINT(DATE(2010,3,5),A2,A3,A4,A5,A6,A7,FALSE) ''displays 23.88888888888889'' as a result.
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">20%</font></font></font>
+
==Related Videos==
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">500</font></font></font>
+
{{#ev:youtube|v=Vdz76Op_qjg|280|center|ACCRINT}}
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">3</font></font></font>
+
== See Also ==
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">0</font></font></font>
+
*[[Manuals/calci/DURATION | DURATION]]
  
<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>
+
== References ==
  
<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>
+
*[http://en.wikipedia.org/wiki/Accrued_interest Accrued Interest]
 +
*[http://en.wikipedia.org/wiki/Day_count_convention Day Count Basis]
  
</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"
+
*[[Z_API_Functions | List of Main Z Functions]]
|- 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>
+
*[[ Z3 |  Z3 home ]]
----
 

Latest revision as of 04:46, 18 November 2020

ACCRINT (Issue,FirstInterest,Settlement,Rate,Par,Frequency,Basis)


  • 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
    • ACCRINT() returns the accrued interest for a security that pays periodic interest.

Description

ACCRINT (Issue,FirstInterest,Settlement,Rate,Par,Frequency,Basis)

  • 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 #N/A error message.
  • If is omitted, Calci displays #N/A error message.
  • If <=0 or <=0, Calci displays #N/A error message.
  • The values for should be 1,2 or 4.

For Annual payment, Frequency = 1,

For Semi-annual payment, Frequency = 2,

For Quarterly payment, Frequency = 4.

  • 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/365
  • If value is other than 0 to 4, Calci displays #N/A error message.


Examples

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

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

Related Videos

ACCRINT

See Also

References