Exceljet

Quick, clean, and to the point

Excel COUPNUM Function

Excel COUPNUM function
Summary 

The Excel COUPNUM function returns the number of coupons, or interest payments, payable between the settlement date and maturity date.

Purpose 
Get number of coupons payable
Return value 
Number of coupons payable
Syntax 
=COUPNUM (settlement, maturity, frequency, [basis])
Arguments 
  • settlement - Settlement date of the security.
  • maturity - Maturity date of the security.
  • frequency - Number of coupon payments per year (annual = 1, semi-annual = 2, quarterly = 4).
  • basis - [optional] Day count basis (see below, default =0).
Usage notes 

Historically, bonds were printed on paper with detachable coupons. The coupons were presented to the bond issuer by the bond holder to collect periodic interest payments.  The Excel COUPNUM function returns the number of coupons (interest payments) payable between the settlement date and maturity date.

The settlement date is the date the investor takes possession of a security. The maturity date is the date when the investment ends and the principle plus accrued interest is returned to the investor.  The frequency is the number of interest payments per year. Basis specifies the method used to count days (see below). In the example show, the formula in F6 is:

=COUPNUM(C6,C7,C10,C11)

Entering dates

In Excel, dates are serial numbers. Generally, the best way to enter valid dates is to use cell references, as shown in the example. To enter valid dates directly, you can use the DATE function. Below is the formula in F6 reworked with hardcoded values and the DATE function:

=COUPNUM(DATE(2019,2,15),DATE(2029,1,1),2,0)

With these inputs, COUPNUM returns the same result.

Basis

The basis argument controls how days are counted. The COUPNUM function allows 5 options (0-4) and defaults to zero, which specifies US 30/360 basis. This article on wikipedia provides a detailed explanation of available conventions.

Basis Day count
0 or omitted US (NASD) 30/360
1 Actual/actual
2 Actual/360
3 Actual/365
4 European 30/360

Notes

  • In Excel, dates are serial numbers
  • All arguments are truncated to integers, so for example, time is ignored.
  • If settlement or maturity dates are not valid, COUPNUM returns #VALUE!
  • If basis is out-of-range , COUPNUM returns #NUM!
  • If maturity date is not later than settlement date, COUPNUM returns #NUM!

Excel Formula Training

Formulas are the key to getting things done in Excel. In this accelerated training, you'll learn how to use formulas to manipulate text, work with dates and times, lookup values with VLOOKUP and INDEX & MATCH, count and sum with criteria, dynamically rank values, and create dynamic ranges. You'll also learn how to troubleshoot, trace errors, and fix problems. Instant access. See details here.