The Excel COUPDAYS Function

Related Functions:
COUPDAYBS
COUPDAYSNC

Basic Description

The Excel COUPDAYS function calculates the number of days in a coupon period that contains the settlement date.

The syntax of the function is :

COUPDAYS( settlement, maturity, frequency, [basis] )

Where the arguments are as follows:

settlement - The security's settlement date
maturity - The security's maturity date
frequency -

The number of coupon payments per year. This must have one of the following values:

1 - Annually
2 - Semi-Annually
4 - Quarterly
[basis] - An optional argument which defines the day count basis to be used in the calculation.
This may have any of the following values :
Basis Day Count Basis
0 (or omitted) US (NASD) 30/360
1 actual/actual
2 actual/360
3 actual/365
4 European 30/360
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:

or

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


Excel Coupdays Function Example

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.

 Formulas:
  A
1 01-Jan-2011
2 25-Oct-2012
3 =COUPDAYS( A1, A2, 4 )
 Results:
  A
1 01-Jan-2011
2 25-Oct-2012
3 90

Note that, in the above example :


More details and examples of the Excel Coupdays function are provided on the Microsoft Office website.


Coupdays Function Errors

If you get an error from the Excel Coupdays Function, this is most likely to be one of the following:

Common Errors
#VALUE! - Occurs if either:
- the supplied settlement or the supplied maturity date is not a valid Excel date
or
- the supplied frequency or the supplied [basis] argument is non-numeric
#NUM! - Occurs if either:
- the supplied settlement date is ≥ maturity date
or
- the supplied frequency argument is a number that is not equal to 1, 2 or 4
or
- the supplied [basis] argument is a number that is not equal to 0, 1, 2, 3 or 4
#NAME? -

Occurs when Analysis ToolPak add-in is not enabled in your Excel.
You will need to enable the add-in if you want to use the Excel Coupdays function.

  +   Show How to Do This in Excel 2003:

  +   Show How to Do This in Excel 2007:

  +   Show How to Do This in Excel 2010 or Excel 2013:

Return to the Excel Financial Functions Page

Return to the List of All Built-In Excel Functions

Valid XHTML 1.0 Transitional Valid CSS!
Disclaimer   Privacy Policy
Copyright © 2008-2014 ExcelFunctions.net