Practice free

COUPDAYBS function

COUPDAYBS counts the days from the start of the current coupon period to the settlement date. It is used to work out accrued interest on a bond bought mid-period.

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 from the start of the coupon period to settlement, using basis 0.

Practice this in the app

Syntax

COUPDAYBS(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 from the previous coupon date to settlement.

What Excel actually returns

Each formula below was run in desktop Excel. The result is exactly what the cell showed, errors included.

FormulaExcel showsCase
=COUPDAYBS(DATE(2024,2,15),DATE(2034,11,15),2,0) 90 Semiannual
=COUPDAYBS(DATE(2024,2,15),DATE(2034,11,15),2) 90 Basis omitted
=COUPDAYBS(DATE(2024,2,15),DATE(2034,11,15),1,0) 90 Frequency 1
=COUPDAYBS(DATE(2024,2,15),DATE(2034,11,15),4,0) 0 Frequency 4
=COUPDAYBS(DATE(2024,2,15),DATE(2034,11,15),2.9,0) 90 Frequency 2.9 truncates
=COUPDAYBS(DATE(2024,2,15),DATE(2034,11,15),2,0) 90 Basis 0
=COUPDAYBS(DATE(2024,2,15),DATE(2034,11,15),3,0) #NUM! Frequency 3
=COUPDAYBS(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
COUPDAYBS 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 .