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...")
 
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
<div id="6SpaceContent" class="zcontent" align="left"> 
+
<div style="font-size:25px">'''COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)'''</div><br/>
  
−
<font face="Arial, sans-serif">'''COUPDAYS(settle, M, F, basis)'''</font>
+
*Where <math>SettlementDate</math> is the security's settlement date (a date when coupon or a bond is purchased),  
−
+
*<math>MaturityDate</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
−
<font face="Arial, sans-serif">Where 'settle' is the security's settlement date,</font>
+
*<math>Basis</math> is the type of day count basis to use.
 +
**COUPDAYS(), returns the number of days in the coupon period that contains the settlement date.
  
−
<font face="Arial, sans-serif">'M' is the security's maturity date, </font>
+
== Description ==
  
−
<font face="Arial, sans-serif">'F' is the number of coupon payments per year and </font>
+
COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)
  
−
<font face="Arial, sans-serif">'basis' is the type of day count basis to use.</font>
+
*COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
 +
*<math>SettlementDate</math> and <math>MaturityDate</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>SettlementDate</math>  ≥ <math>MaturityDate</math> date, Calci displays #N/A error message.
 +
*The values for <math>Frequency</math> should be 1,2 or 4.
 +
For Annual payment, Frequency = 1,
  
−
</div>
+
For Semi-annual payment, Frequency = 2,
−
----
 
−
<div id="1SpaceContent" class="zcontent" align="left"> <font face="Arial, sans-serif">This function calculates the number of days in the </font>
 
  
−
<font face="Arial, sans-serif">coupon period that contains the settlement date.</font>
+
For Quarterly payment, Frequency = 4.
  
−
</div>
+
*<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 id="7SpaceContent" class="zcontent" align="left"> 
 
  
−
*  <font face="Arial, sans-serif">COUPDAYS shows the error value when 'settle' </font>
+
{| class="wikitable"
−
*  <font face="Arial, sans-serif">or 'M' is not a valid date or  </font>
+
|-
−
*  <font face="Arial, sans-serif"> settlement ≥ maturity</font>
+
! Basis !! Description
−
*  <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>
+
| 0 || US (NASD) 30/360
−
*  <font face="Arial, sans-serif">Otherwise it shows error. </font>
+
|-
−
*  <font face="Arial, sans-serif">If settlement ≥ maturity, </font>
+
| 1 || Actual/actual
−
*  <font face="Arial, sans-serif">COUPDAYS returns the #NUM! error value. </font>
+
|-
−
 
+
| 2 || Actual/360
−
+
|-
−
 
+
| 3 || Actual/365
−
</div>
+
|-
−
----
+
| 4 || European 30/360
−
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
+
|}
  
−
COUPDAYS
+
*If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message.
  
−
</div></div>
+
== Examples ==
−
----
 
−
<div id="8SpaceContent" class="zcontent" align="left"> 
 
  
−
<font face="Arial, sans-serif">Lets see an example,</font>
+
Consider the following example that shows the use of COUPDAYS function:
−
 
−
<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.
 +
 
 +
==Related Videos==
 +
 
 +
{{#ev:youtube|v=Sdod6NuKvOU|280|center|COUPDAYS}}
 +
 
 +
== 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]
 +
 
 +
 
 +
 
 +
*[[Z_API_Functions | List of Main Z Functions]]
 +
 
 +
*[[ Z3 |  Z3 home ]]

Latest revision as of 14:26, 15 November 2018

COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)


  • Where Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle SettlementDate} is the security's settlement date (a date when coupon or a bond is purchased),
  • Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle MaturityDate} is the security's maturity date (a date when coupon or a bond expires),
  • Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Frequency} is the number of coupon payments per year, and
  • Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis} is the type of day count basis to use.
    • COUPDAYS(), returns the number of days in the coupon period that contains the settlement date.

Description

COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)

  • COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
  • Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle SettlementDate} and Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle MaturityDate} 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 Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle SettlementDate} ≥ Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle MaturityDate} date, Calci displays #N/A error message.
  • The values for Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Frequency} should be 1,2 or 4.

For Annual payment, Frequency = 1,

For Semi-annual payment, Frequency = 2,

For Quarterly payment, Frequency = 4.

  • Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis} value is optional. If omitted, Calci assumes it to be 0.

Below table shows the use of Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis} values:

Basis Description
0 US (NASD) 30/360
1 Actual/actual
2 Actual/360
3 Actual/365
4 European 30/360
  • If Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle 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.

Related Videos

COUPDAYS

See Also

References


Retrieved from "http://wiki.zcubes.com/index.php?title=Manuals/calci/COUPDAYS&oldid=211333"