Difference between revisions of "Manuals/calci/COUPDAYS"

From ZCubes Wiki
Jump to navigation Jump to search
(Created page with "<div id="6SpaceContent" class="zcontent" align="left">  <font face="Arial, sans-serif">'''COUPDAYS(settle, M, F, basis)'''</font> <font face="Arial, sans-serif">W...")
 
Line 1: Line 1:
<div id="6SpaceContent" class="zcontent" align="left"> 
+
=COUPDAYS(settlement, maturity, frequency, basis)=
  
<font face="Arial, sans-serif">'''COUPDAYS(settle, M, F, basis)'''</font>
+
*Where 'settlement' is the security's settlement date (a date when coupon or a bond is purchased),  
+
*'maturity' is the security's maturity date (a date when coupon or a bond expires),
+
*'frequency' is the number of coupon payments per year, and
<font face="Arial, sans-serif">Where 'settle' is the security's settlement date,</font>
+
*'basis' is the type of day count basis to use.
  
<font face="Arial, sans-serif">'M' is the security's maturity date, </font>
+
COUPDAYS() calculates the number of days in the coupon period.
  
<font face="Arial, sans-serif">'F' is the number of coupon payments per year and </font>
+
== Description ==
  
<font face="Arial, sans-serif">'basis' is the type of day count basis to use.</font>
+
COUPDAYS(settlement, maturity, frequency, basis)
  
</div>
+
*COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
----
+
*Settlement and maturity dates should be entered either in 'date format' or 'dates returned using formulas'. If dates are not valid, Calci displays #N/A error message.
<div id="1SpaceContent" class="zcontent" align="left"> <font face="Arial, sans-serif">This function calculates the number of days in the </font>
+
*If settlement date ≥ maturity date, Calci displays #N/A error message.
 +
*'coupon' and 'yield' values must be greater than or equal to zero.
 +
*The values for 'frequency' should be 1,2 or 4.
 +
For Annual payment, frequency = 1,
  
<font face="Arial, sans-serif">coupon period that contains the settlement date.</font>
+
For Semi-annual payment, frequency = 2,
  
</div>
+
For Quarterly payment, frequency = 4.
----
 
<div id="7SpaceContent" class="zcontent" align="left"> 
 
  
* <font face="Arial, sans-serif">COUPDAYS shows the error value when 'settle' </font>
+
*'basis' value is optional. If omitted, Calci assumes it to be 0.  
*  <font face="Arial, sans-serif">or 'M' is not a valid date or  </font>
+
Below table shows the use of 'basis' values:
*  <font face="Arial, sans-serif"> settlement ≥ maturity</font>
 
*  <font face="Arial, sans-serif">'F' value should be 1,2 or 4 and</font>
 
*  <font face="Arial, sans-serif"> 'basis' is between 0 and 4. </font>
 
*  <font face="Arial, sans-serif">Otherwise it shows error. </font>
 
*  <font face="Arial, sans-serif">If settlement ≥ maturity, </font>
 
*  <font face="Arial, sans-serif">COUPDAYS returns the #NUM! error value. </font>
 
  
+
{| class="wikitable"
 +
|-
 +
! Basis !! Description
 +
|-
 +
| 0 || US (NASD) 30/360
 +
|-
 +
| 1 || Actual/actual
 +
|-
 +
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/365
 +
|}
  
</div>
+
*If 'basis' value is other than 0 to 4, Calci displays #N/A error message.
----
 
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
 
  
COUPDAYS
+
== Examples ==
  
</div></div>
+
Consider the following example that shows the use of COUPDAYS function:
----
 
<div id="8SpaceContent" class="zcontent" align="left"> 
 
  
<font face="Arial, sans-serif">Lets see an example,</font>
 
 
<font face="Arial, sans-serif">COUPDAYS(settle, M, F, basis)</font>
 
 
<font face="Arial, sans-serif">'''B'''</font>
 
 
<font face="Arial, sans-serif">06-20-2009</font>
 
 
<font face="Arial, sans-serif">12-10-2010</font>
 
 
<font face="Arial, sans-serif">2</font>
 
 
<font face="Arial, sans-serif">1</font>
 
 
<font face="Arial, sans-serif">=COUPDAYS(B2,B3,B4,B5)is 183</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" | 06-20-2009
+
| class=" " |
| class="                                                                                 sshl_f  " |
+
| class=" " |
|
+
 
|
 
 
|- class="even"
 
|- class="even"
| class=" " | Row2
+
| class=" " | 2
| class="sshl_f" | 12-10-2010
+
| class=" " |
|
+
| class=" " |
|
+
 
|
 
 
|- class="odd"
 
|- class="odd"
| Row3
+
| class=" " | 1
| class="sshl_f" | 2
+
| class=" " |
|
+
| class=" " |
|
 
|
 
|- class="even"
 
| Row4
 
| class="sshl_f" | 1
 
|
 
|
 
|
 
|- class="odd"
 
| class=" " | Row5
 
| class="sshl_f" | 183
 
|
 
|
 
|
 
|- class="even"
 
| Row6
 
| class="SelectTD" |
 
|
 
|
 
|
 
 
|}
 
|}
  
<div align="left">[[Image:calci1.gif]]</div></div>
+
=COUPDAYS(A1,A2,A3,A4) ''displays 183'' as a result.
----
+
=COUPDAYS(DATE(2012,1,1),DATE(2013,1,1),1,1) ''displays 366'' as a result.
 +
 
 +
== See Also ==
 +
 
 +
*[[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 16:23, 17 January 2014

COUPDAYS(settlement, maturity, frequency, basis)

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

COUPDAYS() calculates the number of days in the coupon period.

Description

COUPDAYS(settlement, maturity, frequency, basis)

  • COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
  • Settlement and maturity 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 settlement date ≥ maturity date, Calci displays #N/A error message.
  • 'coupon' and 'yield' values must be greater than or equal to zero.
  • 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.

Examples

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

06/20/2010
12/20/2014
2
1
=COUPDAYS(A1,A2,A3,A4) displays 183 as a result.
=COUPDAYS(DATE(2012,1,1),DATE(2013,1,1),1,1) displays 366 as a result.

See Also

References