Manuals/calci/COUPDAYS
Jump to navigation
Jump to search
COUPDAYS(settlement, maturity, frequency, basis)
- Where 'settlement' is the security's settlement date (a date when coupon or a bond is purchased),
- 'maturity' is the security's maturity date (a date when coupon or a bond expires),
- 'frequency' is the number of coupon payments per year, and
- 'basis' is the type of day count basis to use.
COUPDAYS() calculates the number of days in the coupon period.
Description
COUPDAYS(settlement, maturity, frequency, basis)
- COUPDAYS() calculates the number of days between the coupon dates surrounding the settlement date.
- Settlement and 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 settlement date ≥ maturity date, Calci displays #N/A error message.
- 'coupon' and 'yield' values must be greater than or equal to zero.
- The values for 'frequency' should be 1,2 or 4.
For Annual payment, frequency = 1,
For Semi-annual payment, frequency = 2,
For Quarterly payment, frequency = 4.
- 'basis' value is optional. If omitted, Calci assumes it to be 0.
Below table shows the use of 'basis' values:
| Basis | Description |
|---|---|
| 0 | US (NASD) 30/360 |
| 1 | Actual/actual |
| 2 | Actual/360 |
| 3 | Actual/365 |
| 4 | European 30/365 |
- If '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.