Difference between revisions of "Manuals/calci/COUPNUM"
Jump to navigation
Jump to search
| (6 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | =COUPNUM( | + | <div style="font-size:25px">'''COUPNUM(Settlement, Maturity, Frequency, Basis)'''</div><br/> |
| − | *Where <math> | + | *Where <math>Settlement</math> is the security's settlement date (a date when coupon or a bond is purchased), |
| − | *<math> | + | *<math>Maturity</math> is the security's maturity date (a date when coupon or a bond expires), |
| − | *<math> | + | *<math>Frequency</math> is the number of coupon payments per year, and |
| − | *<math> | + | *<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. | |
| − | COUPNUM() | ||
== Description == | == Description == | ||
| − | COUPNUM( | + | COUPNUM(Settlement, Maturity, Frequency, Basis) |
| − | *<math> | + | *<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> | + | *If <math>Settlement</math> date = <math>Maturity</math> date, Calci displays #N/A error message. |
| − | *The values for <math> | + | *The values for <math>Frequency</math> should be 1,2 or 4. |
For Annual payment, frequency = 1, | For Annual payment, frequency = 1, | ||
| Line 21: | Line 20: | ||
For Quarterly payment, frequency = 4. | For Quarterly payment, frequency = 4. | ||
| − | *<math> | + | *<math>Basis</math> value is optional. If omitted, Calci assumes it to be 0. |
| − | Below table shows the use of <math> | + | Below table shows the use of <math>Basis</math> values: |
{| class="wikitable" | {| class="wikitable" | ||
| Line 39: | Line 38: | ||
|} | |} | ||
| − | *If <math> | + | *If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message. |
== Examples == | == Examples == | ||
| Line 71: | Line 70: | ||
=COUPNUM(A1,A2,A3,A4) ''displays 9'' as a result. | =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. | =COUPNUM(DATE(2012,1,31),DATE(2014,1,6),1,1) ''displays 2'' as a result. | ||
| + | |||
| + | ==Related Videos== | ||
| + | |||
| + | {{#ev:youtube|v=I_0hUfecM-U|280|center|COUPNUM}} | ||
== See Also == | == See Also == | ||
| Line 82: | Line 85: | ||
*[http://en.wikipedia.org/wiki/Coupon_(bond) Coupon] | *[http://en.wikipedia.org/wiki/Coupon_(bond) Coupon] | ||
*[http://en.wikipedia.org/wiki/Day_count_convention Day Count Basis] | *[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:42, 15 November 2018
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(), returns the number of coupons payable between the settlement date and maturity date.
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.
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.
Related Videos
See Also
References