COUPDAYBS Function
Calculates the number of days from the beginning of the coupon period to the settlement date.
Syntax
Parameters
| Parameter | Description | Required |
|---|---|---|
| settlement | Date the security is purchased. | Required |
| maturity | Date the security expires. | Required |
| frequency | Number of coupon payments per year (1, 2, or 4). | Required |
| basis | Day-count convention (0 = US 30/360, default). | Optional |
Basic Example
Days from coupon start to settlement
=COUPDAYBS(DATE(2024,4,1), DATE(2034,4,1), 2)For a bond purchased on April 1, 2024 with semi-annual coupons, this returns the number of days since the coupon period began.
Advanced Examples
Example 1: With actual/actual basis
Treasury bondUse basis 1 for actual/actual
=COUPDAYBS(DATE(2024,4,1), DATE(2034,4,1), 2, 1)How COUPDAYBS Works
COUPDAYBS is used in bond pricing to determine accrued interest. It identifies where the settlement date falls within the current coupon period.
Important Notes & Limitations
Settlement date must be before maturity date.
Frequency must be 1, 2, or 4.
Basis affects the day count.
Common Errors & Fixes
#NUM! errorInvalid dates, frequency, or basis.Fix: Verify all inputs.
#VALUE! errorDates are not recognized.Fix: Use DATE function or valid date serial numbers.
Download Practice File
COUPDAYBS
coupdaybsPractice COUPDAYBS with Real Data
Download a sample CSV file with pre-populated data and practice exercises for the COUPDAYBS function. Works in both Excel and Google Sheets.
File format: CSV (comma-separated values) - opens in Excel, Google Sheets, and all spreadsheet apps