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>''...")
 
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
<div id="6SpaceContent" class="zcontent" align="left"> 
+
<div style="font-size:25px">'''COUPNUM(Settlement, Maturity, Frequency, Basis)'''</div><br/>
  
−
<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.
 +
**COUPNUM(), returns the number of coupons payable between the settlement date and maturity date.
  
−
<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>
+
== Description ==
  
−
</div>
+
COUPNUM(Settlement, Maturity, Frequency, Basis)
−
----
 
−
<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>
+
*<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.
 +
*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="7SpaceContent" class="zcontent" align="left"> 
 
  
−
* <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 Quarterly payment, frequency = 4.
  
−
* <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>
+
*<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0.  
 +
Below table shows the use of <math>Basis</math> values:
  
−
<br /><br />
+
{| class="wikitable"
 +
|-
 +
! Basis !! Description
 +
|-
 +
| 0 || US (NASD) 30/360
 +
|-
 +
| 1 || Actual/actual
 +
|-
 +
| 2 || Actual/360
 +
|-
 +
| 3 || Actual/365
 +
|-
 +
| 4 || European 30/360
 +
|}
 +
 
 +
*If <math>Basis</math> 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:
 +
 
 +
<div id="2SpaceContent" class="zcontent" align="left">
 +
 
 +
{| id="TABLE3" class="SpreadSheet blue"
 +
|- class="even"
 +
| class=" " | 06/20/2010
 +
| class=" " |
 +
| class=" " |
  
−
</div>
+
|- class="odd"
−
----
+
| class="sshl_f" | 12/20/2014
−
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
+
| class=" " |
 +
| class=" " |
  
−
COUPNUM
+
|- class="even"
 +
| class=" " | 2
 +
| class=" " |
 +
| class=" " |
  
−
</div></div>
+
|- class="odd"
−
----
+
| class=" " | 1
−
<div id="8SpaceContent" class="zcontent" align="left"> 
+
| class=" " |
 +
| class=" " |
 +
|}
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">Lets see an example,</font></font></font>
+
=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.
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">COUPNUM(settle, M, F, basis)</font></font></font>
+
==Related Videos==
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">B</font></font></font>
+
{{#ev:youtube|v=I_0hUfecM-U|280|center|COUPNUM}}
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">April 21, 2010</font></font></font>
+
== See Also ==
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">December 10, 2011</font></font></font>
+
*[[Manuals/calci/COUPDAYS | COUPDAYS]]
 +
*[[Manuals/calci/COUPDAYBS | COUPDAYBS]]
 +
*[[Manuals/calci/COUPDAYSNC | COUPDAYSNC]]
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">2</font></font></font>
+
== References ==
  
−
<font color="#000000"><font face="Arial, sans-serif"><font size="2">1</font></font></font>
+
*[http://en.wikipedia.org/wiki/Coupon_(bond) Coupon]
 +
*[http://en.wikipedia.org/wiki/Day_count_convention Day Count Basis]
  
−
<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">
 
  
−
{| id="TABLE3" class="SpreadSheet blue"
+
*[[Z_API_Functions | List of Main Z Functions]]
−
|- class="even"
 
−
| class=" " |
 
−
| Column1
 
−
| class="  " | Column2
 
−
| Column3
 
−
| Column4
 
−
|- class="odd"
 
−
| class=" " | Row1
 
−
| class="sshl_f" | April 21, 2010
 
−
| class="                                                                                                                                    sshl_t ChangeBGColor" |
 
−
| class="sshl_t" |
 
−
| class="sshl_t" |
 
−
|- class="even"
 
−
| class="  " | Row2
 
−
| class="sshl_f" | December 10, 2011
 
−
| class="sshl_t" |
 
−
| class="sshl_t" |
 
−
| class="sshl_t" |
 
−
|- class="odd"
 
−
| Row3
 
−
| class="  " | 2
 
−
| class="sshl_t" |
 
−
| 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>
+
*[[ Z3 |  Z3 home ]]
−
----
 

Latest revision as of 14:42, 15 November 2018

COUPNUM(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.
    • COUPNUM(), returns the number of coupons payable between the settlement date and maturity date.

Description

COUPNUM(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 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.

Related Videos

COUPNUM

See Also

References


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