Difference between revisions of "Manuals/calci/COUPDAYBS"

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">COUPDAYBS(settle, M, F, basis)</font></font>'''</f...")
 
Line 1: Line 1:
−
<div id="6SpaceContent" class="zcontent" align="left"><font color="#000000">'''<font face="Arial, sans-serif"><font size="2">COUPDAYBS(settle, M, F, basis)</font></font>'''</font>
+
=COUPDAYBS(settlement, maturity, frequency, basis)=
  
−
<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 'B' is the type of day count basis to use.</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.
  
−
</div>
+
COUPDAYBS() calculates the number of days from the beginning of coupon period to the settlement date.
−
----
 
−
<div id="1SpaceContent" class="zcontent" align="left"><font color="#000000"><font face="Arial, sans-serif"><font size="2">This function returns the number of days from the beginning of the coupon period to the settlement date.</font></font></font></div>
 
−
----
 
−
<div id="7SpaceContent" class="zcontent" align="left"> 
 
  
−
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">Basis must be between 0 and 4 and 'F' should be 1,2 or 4</font></font></font>
+
== Description ==
  
−
* <font color="#000000"><font face="Arial, sans-serif"><font size="2">When settlement ≥ maturity, COUPDAYBS shows the error value. </font></font></font>
+
COUPDAYBS(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="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
+
*The values for <math>frequency</math> should be 1,2 or 4.
 +
For Annual payment, frequency = 1,
  
−
COUPDAYBS
+
For Semi-annual payment, frequency = 2,
  
−
</div></div>
+
For Quarterly payment, frequency = 4.
−
----
 
−
<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>
+
*<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">COUPDAYBS(settle, M, F, basis)</font></font></font>
+
{| class="wikitable"
−
 
+
|-
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">'''B'''</font></font></font>
+
! Basis !! Description
−
 
+
|-
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">January 25, 2008</font></font></font>
+
| 0 || US (NASD) 30/360
−
 
+
|-
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">November 15, 2009</font></font></font>
+
| 1 || Actual/actual
 +
|-
 +
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/360
 +
|}
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">3</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">1</font></font></font>
+
== Examples ==
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2"><nowiki>=COUPDAYBS(B2,B3,B4,B5) is 71</nowiki></font></font></font>
+
Consider the following example that shows the use of COUPDAYBS function:
  
−
</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=" " | 01/25/2011
 
| class=" " |
 
| class=" " |
−
| Column1
+
| class=" " |
−
| class="SelectTD" | Column2
+
 
−
| Column3
 
−
| Column4
 
 
|- class="odd"
 
|- class="odd"
−
| class=" " | Row1
+
| class="sshl_f" | 12/15/2012
−
| class="sshl_f" | January 25, 2008
+
| class=" " |
−
| class="                                                                     " |
+
| class=" " |
−
|
+
 
−
|
 
 
|- class="even"
 
|- class="even"
−
| class=" " | Row2
+
| class=" " | 1
−
| class="sshl_f" | November 15, 2009
+
| class=" " |
−
|
+
| class=" " |
−
|
+
 
−
|
 
 
|- class="odd"
 
|- class="odd"
−
| Row3
+
| class=" " | 1
−
| class="sshl_f" | 3
+
| class=" " |
−
|
+
| class=" " |
−
|
 
−
|
 
−
|- class="even"
 
−
| Row4
 
−
| class="sshl_f" | 1
 
−
|
 
−
|
 
−
|
 
−
|- class="odd"
 
−
| class=" " | Row5
 
−
| class="sshl_f" | 71
 
−
|
 
−
|
 
−
|
 
−
|- class="even"
 
−
| Row6
 
−
| class="sshl_f" |
 
−
|
 
−
|
 
−
|
 
 
|}
 
|}
  
−
<div align="left">[[Image:calci1.gif]]</div></div>
+
=COUPDAYBS(A1,A2,A3,A4) ''displays 41'' as a result.
−
----
+
=COUPDAYBS(DATE(2008,6,1),DATE(2009,11,1),2,1) ''displays 31'' as a result.
 +
 
 +
== See Also ==
 +
 
 +
*[[Manuals/calci/COUPDAYS | COUPDAYS]]
 +
*[[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 20:44, 17 January 2014

COUPDAYBS(settlement, maturity, 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 settlement} 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 maturity} 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.

COUPDAYBS() calculates the number of days from the beginning of coupon period to the settlement date.

Description

COUPDAYBS(settlement, maturity, frequency, basis)

  • 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 settlement} 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 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 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 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 maturity} 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 COUPDAYBS function:

01/25/2011
12/15/2012
1
1 
=COUPDAYBS(A1,A2,A3,A4) displays 41 as a result.
=COUPDAYBS(DATE(2008,6,1),DATE(2009,11,1),2,1) displays 31 as a result.

See Also

References

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