COUPDAYS function
COUPDAYS tells you how many days are in the coupon period that contains the settlement date, under the day-count basis you choose. Pass dates with DATE() or cell references.
Example
Read it as a sentence: for a bond settled March 1, 2024 that matures January 1, 2025 and pays twice a year, count the days in the coupon period that contains settlement, using basis 0.
Syntax
COUPDAYS(settlement, maturity, frequency, [basis])
Arguments in [square brackets] are optional.
-
settlement(required) - Date the security is bought (after issue, before maturity).
-
maturity(required) - Date the security expires and is repaid.
-
frequency(required) - Coupon payments per year: 1 annual, 2 semiannual, 4 quarterly.
-
basis(optional) - Day-count convention: 0 or omitted = US 30/360, 1 = actual/actual, 2 = actual/360, 3 = actual/365, 4 = European 30/360.
Returns: Number of days in the coupon period containing settlement.
What Excel actually returns
Each formula below was run in desktop Excel. The result is exactly what the cell showed, errors included.
| Formula | Excel shows | Case |
|---|---|---|
=COUPDAYS(DATE(2024,2,15),DATE(2034,11,15),2,0) | 180 | Semiannual |
=COUPDAYS(DATE(2024,2,15),DATE(2034,11,15),2) | 180 | Basis omitted |
=COUPDAYS(DATE(2024,2,15),DATE(2034,11,15),1,0) | 360 | Frequency 1 |
=COUPDAYS(DATE(2024,2,15),DATE(2034,11,15),4,0) | 90 | Frequency 4 |
=COUPDAYS(DATE(2024,2,15),DATE(2034,11,15),2.9,0) | 180 | Frequency 2.9 truncates |
=COUPDAYS(DATE(2024,2,15),DATE(2034,11,15),2,0) | 180 | Basis 0 |
=COUPDAYS(DATE(2024,2,15),DATE(2034,11,15),3,0) | #NUM! | Frequency 3 |
=COUPDAYS(DATE(2024,2,15),DATE(2034,11,15),0,0) | #NUM! | Frequency 0 |
Watch out for
- Pass dates with DATE() or cell references; text dates can misbehave and invalid dates return #VALUE!.
- Coupon dates are counted backwards from maturity, not forwards from issue.
Where it works
- Excel
- COUPDAYS is in every version of Excel from 2007 on.
- Google Sheets
- Same name, same behaviour for everyday use.
Part of Financial functions. Every result on this page was measured in desktop Excel, build 16.0.20527. Last updated .