Difference between revisions of "Manuals/calci/COUPNUM"

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">COUPNUM(settle, M, F, basis)</font></font>''...")
 
Line 1: Line 1:
<div id="6SpaceContent" class="zcontent" align="left"> 
+
=COUPNUM(settlement, maturity, frequency, basis)=
  
<font color="#000000">'''<font face="Arial, sans-serif"><font size="2">COUPNUM(settle, M, F, basis)</font></font>'''</font>
+
*Where <math>settlement</math> is the security's settlement date (a date when coupon or a bond is purchased),
 +
*<math>maturity</math> is the security's maturity date (a date when coupon or a bond expires),  
 +
*<math>frequency</math> is the number of coupon payments per year, and
 +
*<math>basis</math> is the type of day count basis to use.
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">Where 'settle' is the security's settlement date, 'M' is the security's maturity date, 'F' is the number of coupon payments per year, and 'basis' is the type of day count basis to use.</font></font></font>
+
COUPNUM() calculates the number of coupons to be paid between the settlement date and the maturity date.
  
</div>
+
== Description ==
----
 
<div id="1SpaceContent" class="zcontent" align="left"> 
 
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">This function shows the number of coupons allocated between the settlement date and maturity date.</font></font></font>
+
COUPNUM(settlement, maturity, frequency, basis)
  
</div>
+
*<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.
<div id="7SpaceContent" class="zcontent" align="left"> 
+
*The values for <math>frequency</math> should be 1,2 or 4.
 +
For Annual payment, frequency = 1,
  
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">COUPDAYSNC shows the error value, when settlement or maturity is not a valid date, or settlement ≥ maturity.</font></font></font>
+
For Semi-annual payment, frequency = 2,
  
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">Basis should be between 0 and 4 and 'F' should be 1, 2, or 4. Otherwise it shows error value.. </font></font></font>
+
For Quarterly payment, frequency = 4.
  
<br /><br />
+
*<math>basis</math> value is optional. If omitted, Calci assumes it to be 0.
 +
Below table shows the use of <math>basis</math> values:
  
</div>
+
{| class="wikitable"
----
+
|-
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
+
! Basis !! Description
 
+
|-
COUPNUM
+
| 0 || US (NASD) 30/360
 
+
|-
</div></div>
+
| 1 || Actual/actual
----
+
|-
<div id="8SpaceContent" class="zcontent" align="left"> 
+
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/360
 +
|}
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">Lets see an example,</font></font></font>
+
*If <math>basis</math> value is other than 0 to 4, Calci displays #N/A error message.
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">COUPNUM(settle, M, F, basis)</font></font></font>
+
== Examples ==
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">B</font></font></font>
+
Consider the following example that shows the use of COUPNUM function:
  
<font color="#000000"><font face="Arial, sans-serif"><font size="2">April 21, 2010</font></font></font>
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2">December 10, 2011</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">1</font></font></font>
 
 
<font color="#000000"><font face="Arial, sans-serif"><font size="2"><nowiki>=COUPNUM(B2,B3,B4,B5) is 4</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="2SpaceContent" class="zcontent" align="left">
 
<div id="2SpaceContent" class="zcontent" align="left">
  
 
{| id="TABLE3" class="SpreadSheet blue"
 
{| id="TABLE3" class="SpreadSheet blue"
 
|- class="even"
 
|- class="even"
 +
| class=" " | 06/20/2010
 
| class=" " |
 
| class=" " |
| Column1
+
| class=" " |
| class=" " | Column2
+
 
| Column3
 
| Column4
 
 
|- class="odd"
 
|- class="odd"
| class=" " | Row1
+
| class="sshl_f" | 12/20/2014
| class="sshl_f" | April 21, 2010
+
| class=" " |
| class="                                                                                                                                   sshl_t ChangeBGColor" |
+
| class=" " |
| class="sshl_t" |
+
 
| class="sshl_t" |
 
 
|- class="even"
 
|- class="even"
| class=" " | Row2
+
| class=" " | 2
| class="sshl_f" | December 10, 2011
+
| class=" " |
| class="sshl_t" |
+
| class=" " |
| class="sshl_t" |
+
 
| class="sshl_t" |
 
 
|- class="odd"
 
|- class="odd"
| Row3
+
| class=" " | 1
| class="  " | 2
+
| class=" " |
| class="sshl_t" |
+
| class=" " |
| class="sshl_t" |
 
| class="sshl_t" |
 
|- class="even"
 
| Row4
 
| class="sshl_f " | 1
 
| class="sshl_t" |
 
| class="sshl_t" |
 
| class="sshl_t" |
 
|- class="odd"
 
| class=" " | Row5
 
| class="sshl_f" | 4
 
| class="sshl_t" |
 
| class="sshl_t" |
 
| class="sshl_t" |
 
|- class="even"
 
| Row6
 
| class="sshl_f    " |
 
| class="sshl_t" |
 
| class="sshl_t" |
 
| class="sshl_t" |
 
 
|}
 
|}
  
<div align="left">[[Image:calci1.gif]]</div></div>
+
=COUPNUM(A1,A2,A3,A4) ''displays 9'' as a result.
----
+
=COUPNUM(DATE(2012,1,31),DATE(2014,1,6),1,1) ''displays 2'' as a result.
 +
 
 +
== See Also ==
 +
 
 +
*[[Manuals/calci/COUPDAYS | COUPDAYS]]
 +
*[[Manuals/calci/COUPDAYBS | COUPDAYBS]]
 +
*[[Manuals/calci/COUPDAYSNC | COUPDAYSNC]]
 +
 
 +
== References ==
 +
 
 +
*[http://en.wikipedia.org/wiki/Coupon_(bond) Coupon]
 +
*[http://en.wikipedia.org/wiki/Day_count_convention Day Count Basis]

Revision as of 15:58, 18 January 2014

COUPNUM(settlement, maturity, frequency, basis)

  • Where is the security's settlement date (a date when coupon or a bond is purchased),
  • is the security's maturity date (a date when coupon or a bond expires),
  • is the number of coupon payments per year, and
  • is the type of day count basis to use.

COUPNUM() calculates the number of coupons to be paid between the settlement date and the maturity date.

Description

COUPNUM(settlement, maturity, frequency, basis)

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

Examples

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

06/20/2010
12/20/2014
2
1
=COUPNUM(A1,A2,A3,A4) displays 9 as a result.
=COUPNUM(DATE(2012,1,31),DATE(2014,1,6),1,1) displays 2 as a result.

See Also

References