How to Use the COUPDAYS Function in Google Sheets

Published on

The COUPDAYS function in Google Sheets helps you determine the number of days in the coupon period (interest payment period) that contains the settlement date.

If you’re unfamiliar with the term “settlement date,” don’t worry! It’s explained in detail in the Arguments section below. Scroll down to learn more.

Before diving into how to use the COUPDAYS function, let’s first clarify the term “coupon”, which will help you understand the function better.

What Is a Coupon?

For first-time bond investors, the term “coupon” can be confusing. In simple terms, it refers to the annual interest payment that the bondholder receives from the bond’s issue date until it matures.

In the past, investors who purchased bonds were given physical certificates that had a series of attached coupons (scheduled interest payments). While these physical coupons are no longer used, the term “coupon” has stuck.

For example, if you have a $1,000 bond with a 6% coupon, it will pay $60 annually. If the payment frequency is semiannual (twice a year), the bondholder will receive $30 twice a year.

As a side note, if you want to find the number of coupon payments, you can use the COUPNUM function. The arguments for both the COUPNUM and COUPDAYS functions are the same.

COUPDAYS Function in Google Sheets: Syntax and Arguments

Syntax:

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

Arguments:

  • settlement – The settlement date of the security (bond). This is the date after issuance when the bond is traded to the buyer.
  • maturity – The maturity or expiry date of the bond.
  • frequency – The number of coupon payments per year (annual, semiannual, or quarterly).
  • day_count_convention – This optional argument specifies the method used for counting days in the coupon period.
    Available options:
    • 0 – US 30/360 (30-day months and 360-day years as per NASD standards)
    • 1 – Actual/Actual (commonly used for non-financial purposes)
    • 2 – Actual/360
    • 3 – Actual/365
    • 4 – European 30/360 (follows European conventions for 30-day months and 360-day years)

Example of COUPDAYS Function in Google Sheets

Let’s explore how to use the COUPDAYS function with cell references.

In this example, you’ll use the settlement date, maturity date, frequency, and day count convention as inputs.

COUPDAYS function example in Google Sheets calculating days in a coupon period

Formula:

=COUPDAYS(C3, C4, C6, C7)

Here, the COUPDAYS formula in Cell F2 returns the number of coupon days as 180. Now, if you change the frequency in Cell C6 to 1, the formula will return 360 days.

This means:

  • A frequency of 1 corresponds to 360 days (annual payments),
  • A frequency of 2 gives 180 days (semiannual payments),
  • A frequency of 4 gives 90 days (quarterly payments).

If you change the day count convention from 0 to 1, the results will be 365 days, 181 days, and 90 days respectively, reflecting a different method of counting days.

In summary, the day count convention plays a crucial role in calculating coupon days using the COUPDAYS function in Google Sheets.

Using COUPDAYS with Input Values Directly

If you’re entering values directly in the COUPDAYS function, use the DATE function to input the settlement and maturity dates.

For example, if your settlement date is 31/1/2019 and your maturity date is 1/1/2020, you must enter them as:

DATE(2019, 1, 31)

and

DATE(2020, 1, 1)

Even if your dates are formatted as mm/dd/yyyy, you still need to use the DATE function in this format.

Common Errors in the COUPDAYS Function

There are two common errors you might encounter when using the COUPDAYS function in Google Sheets: #VALUE! and #NUM!.

Causes of Errors:

  • #VALUE! error occurs when you input invalid dates.
  • #NUM! error is caused by:
    • Using out-of-range values for the frequency or day count convention.
    • Having the settlement date greater than or equal to the maturity date.

That’s all you need to know about the COUPDAYS function in Google Sheets! Hope this guide helps you effectively use the function. Enjoy!

Prashanth KV
Prashanth KV
Your Trusted Google Sheets and Excel Guide Prashanth KV brings a wealth of experience in Google Sheets and Excel, cultivated through years of work with multinational corporations in Mumbai and Dubai. As a recognized Google Product Expert in Docs Editors, Prashanth shares his expertise through insightful blogging since 2012. Explore his blog for practical tips and guidance on maximizing your spreadsheet skills.

Lookup Values Under Categories in Excel and Google Sheets

We can use a combination of XLOOKUP and VLOOKUP in both Excel and Google...

Extract Items Under a Category from the Same Column in Excel

In Excel, you can use a combination of the XLOOKUP and DROP functions to...

How to Create a Searchable Table in Excel Using the FILTER Function

Finding specific records, or rows containing the required information, is straightforward in Excel using...

Time Sequences in Excel by Minute, Hour, or Second Increments

Creating time sequences, whether by hour, minute, or second increments in Excel, can be...

More like this

XMATCH Row by Row: Finding Values Across a Range in Google Sheets

Using the BYROW function with XMATCH in Google Sheets allows us to match values...

Limit Formula Expansion to a Specific Row in Google Sheets

In this tutorial, I’ll explain how to limit the expansion of an array formula...

3-D Referencing Structured Data Tables in Google Sheets

When you have several tables within a single sheet—not across multiple sheets in a...

LEAVE A REPLY

Please enter your comment!
Please enter your name here

This site uses Akismet to reduce spam. Learn how your comment data is processed.