COUPDAYS: Excel Formulae Explained

The COUPDAYS function in Excel is a financial function that calculates the total number of coupon or interest payments between the settlement date and the next coupon date of a specified security. This function is particularly useful for financial analysts and investors who deal with bonds and other fixed-income securities. In this comprehensive guide, we will delve into the intricacies of the COUPDAYS function, its syntax, usage, and potential errors.

Understanding the COUPDAYS Function

The COUPDAYS function is part of Excel's suite of financial functions. It is designed to calculate the total number of coupon days in the coupon period that contains the settlement date. In simpler terms, it tells you how many days are in the period between when a bond is issued or purchased and when the next coupon payment is due.

Understanding this function is crucial for financial analysts and investors as it helps in calculating the accrued interest of a bond, which is a significant factor in bond pricing. The COUPDAYS function is also used in various other financial calculations such as yield to maturity (YTM), bond duration, and bond convexity.

Syntax and Arguments of the COUPDAYS Function

The syntax of the COUPDAYS function in Excel is as follows:

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

This function has four arguments, two of which are mandatory (settlement, maturity, and frequency) and one optional ([basis]). Let's explore each of these arguments in detail.


The settlement argument refers to the settlement date of the security, which is the date after the issue date when the security is traded to the buyer. Excel requires this date to be entered as a valid Excel date using the DATE function.


The maturity argument is the maturity date of the security. This is the date when the security expires. Like the settlement date, the maturity date should also be entered as a valid Excel date.


The frequency argument indicates the number of coupon payments per year. It can be annual (1), semi-annual (2), or quarterly (4).


The basis argument is optional and specifies the day count basis to be used. If omitted, Excel uses the default (0), which represents the US (NASD) 30/360 basis. Other options include actual/actual (1), actual/360 (2), actual/365 (3), and European 30/360 (4).

Using the COUPDAYS Function in Excel

Now that we understand the syntax and arguments of the COUPDAYS function, let's see how to use it in Excel with a practical example.

Suppose you have a bond with a settlement date of January 1, 2020, a maturity date of January 1, 2025, and semi-annual payments. To calculate the number of coupon days, you would use the following formula:

=COUPDAYS(DATE(2020,1,1), DATE(2025,1,1), 2)

The result would be 180, indicating that there are 180 days in the coupon period containing the settlement date.

Potential Errors with the COUPDAYS Function

While the COUPDAYS function is straightforward to use, there are potential errors that you may encounter. These errors are usually due to incorrect or invalid input values.

#NUM! Error

The #NUM! error occurs when the settlement date is greater than the maturity date, the frequency is any number other than 1, 2, or 4, or the basis is any number other than 0, 1, 2, 3, or 4.

#VALUE! Error

The #VALUE! error occurs when the settlement date or maturity date is not a valid date.


The COUPDAYS function in Excel is a powerful tool for financial analysis, particularly for those dealing with bonds and other fixed-income securities. By understanding its syntax, arguments, and potential errors, you can effectively use this function to calculate the number of coupon days, aiding in various financial calculations.

Take Your Financial Analysis Further with Causal

Now that you've mastered the COUPDAYS function in Excel, elevate your financial modelling and analysis with Causal. As a dedicated platform for numerical data and calculations, Causal streamlines the process of modelling, forecasting, and scenario planning. Visualize your data with clarity using interactive charts and dashboards, and present your findings with confidence. Ready to transform your financial analysis experience? Sign up today and discover the simplicity and power of Causal for yourself.

Move beyond 


Get started with Causal today.
Build models effortlessly, connect them directly to your data, and share them with interactive dashboards and beautiful visuals.