The Excel COUPDAYS function calculates the number of days in a coupon period that contains the settlement date.
Where the arguments are as follows:
|settlement||-||The security's settlement date|
|maturity||-||The security's maturity date|
The number of coupon payments per year. This must have one of the following values:
|[basis]||-||An optional argument which defines the day count basis to be used in the calculation.|
This may have any of the following values :
A detailed explanation of the financial day count basis rules is provided on the Wikipedia Day Count Convention page
As the settlement and maturity arguments are dates, these should be input to the function as either:
- If you attempt to input these dates as text, it is possible that they may be misinterpreted, due to different date systems, or date interpretation settings on your computer.
Warning: Although you can supply dates as serial numbers, this is not recommended as the serial numbers may vary across different computer systems.
Cell A3 of the spreadsheet below shows the Excel Coupdays function, used to calculate the number of days in the period containing the settlement date, for a security that has the settlement date 01-Jan-2011, maturity date 25-Oct-2012, and 4 payments per year. The US (NASD) 30/360 day count basis is used.
The spreadsheet on the left shows the format of the function and the spreadsheet on the right shows the function result.
Note that, in the above example :
More details and examples of the Excel Coupdays function are provided on the Microsoft Office website.
If you get an error from the Excel Coupdays Function, this is most likely to be one of the following:
Occurs when Analysis ToolPak add-in is not enabled in your Excel.