Difference between revisions of "Manuals/calci/COUPDAYS"
Jump to navigation
Jump to search
| (6 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | =COUPDAYS( | + | <div style="font-size:25px">'''COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)'''</div><br/> |
| − | *Where <math> | + | *Where <math>SettlementDate</math> is the security's settlement date (a date when coupon or a bond is purchased), |
| − | *<math> | + | *<math>MaturityDate</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. |
| − | + | **COUPDAYS(), returns the number of days in the coupon period that contains the settlement date. | |
| − | COUPDAYS() | ||
== Description == | == Description == | ||
| − | COUPDAYS( | + | COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis) |
*COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date. | *COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date. | ||
| − | *<math> | + | *<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> | + | *If <math>SettlementDate</math> ≥ <math>MaturityDate</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, | + | For Annual payment, Frequency = 1, |
| − | For Semi-annual payment, | + | For Semi-annual payment, Frequency = 2, |
| − | For Quarterly payment, | + | 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 40: | Line 39: | ||
|} | |} | ||
| − | *If <math> | + | *If <math>Basis</math> value is other than 0 to 4, Calci displays #N/A error message. |
== Examples == | == Examples == | ||
| Line 72: | Line 71: | ||
=COUPDAYS(A1,A2,A3,A4) ''displays 183'' as a result. | =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. | =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 == | == 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:26, 15 November 2018
COUPDAYS (SettlementDate,MaturityDate,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.
- COUPDAYS(), returns the number of days in the coupon period that contains the settlement 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
COUPDAYS (SettlementDate,MaturityDate,Frequency,Basis)
- COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
- 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, 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 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
See Also
References