## Excel COUPDAYBS Function

### Description

The COUPDAYBS function returns the number of days between the beginning of the coupon period and its settlement date.

### Syntax and arguments

Formula syntax

COUPDAYBS(settlement, maturity, frequency, [basis])

Arguments

 Settlement: Required, the settlement date of the security. The settlement date is the date that the security is traded to buyer after the issue date. Maturity: Required, the maturity date of the security. The maturity date is the date that the security expires. Frequency: Required, the number of coupon payments per year. There are 3 types, for annual payment, frequency=1, for semiannual, frequency=2, for quarterly, frequency=4. Basis: Optional, the type of day count basis to use. Default, it is omitted.

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

Return Value

The DCOUNTA function returns a numeric value.

Errors

1. If the arguments settlement and maturity are not valid dates, such as are the non-numeric value, or the dates that are earlier than 1/1/1900, the function will return to an error value #VALUE!.

2. If the argument basis is out of range (0-4), the function will return to an error value #NUM!.

3. If the argument frequency is out of the number 1,2,4, the function will return to an error value #NUM!.

4. If the argument settlement date is later than maturity date, the function will return to an error value #NUM!.

Remarks

1. In Excel, dates are stored as serial number. Default, Excel is the 1/1/1900 system which means that 1/1/1900 is the first valid day in Excel and stored as number 1 in Excel. So 1/1/2021 is stored as number 44197.

2. All arguments are truncated to integers, if the arguments including time, the time will be ignored.

3. In the function, you should better use a date with cell reference or you can directly use DATE function embedded in the COUPDAYBS function as this:
=COUPDAYBS(DATE(2021,1,1),DATE(2030,12,1),2,0)

Version

Excel 2003 or later

### Usage and Examples

Example basic usage

For instance, in the range B3:C9, it lists all information about a security. (a 10-year security is issued on 1st Dec, 2020, then be traded to buyer on 1st Jan, 2021 (settlement date), and the maturity date of the security would be 1st Dec, 2030, which is 10 years after the issued date (1st Dec, 2021), and its payments are twice per year.)

Now to count the days from the beginning of the security period until the settlement date, please use the formula as this:

=COUPDAYBS(C4,C5,C8) //here the basis is omitted

Press Enter key to get the result.

#### Relative Functions:

• Excel ACCRINT Function
The ACCRINT function returns the accrued interest on periodic interest-paying securities.

• Excel ACCRINTM Function
The ACCRINTM function returns the accrued interest for a security that pays interest at maturity.

• Excel AMORDEGRC Function
The AMORDEGRC function returns the linear depreciation of an asset for each accounting period by applying a depreciation coefficient based on the lifetime of the assets.

### The Best Office Productivity Tools

#### Kutools for Excel - Helps You To Stand Out From Crowd

 ðŸ¤– Kutools AI Aide: Revolutionize data analysis based on: Intelligent Execution   |  Generate Code  |  Create Custom Formulas  |  Analyze Data and Generate Charts  |  Invoke Kutools Functionsâ€¦ Popular Features: Find, Highlight or Identify Duplicates  |  Delete Blank Rows  |  Combine Columns or Cells without Losing Data  |  Round without Formula ... Super VLookup: Multiple Criteria  |  Multiple Value  |  Across Multi-Sheets  |  Fuzzy Lookup... Adv. Drop-down List: Easy Drop Down List  |  Dependent Drop Down List  |  Multi-select Drop Down List... Column Manager: Add a Specific Number of Columns  |  Move Columns  |  Toggle Visibility Status of Hidden Columns  |  Compare Columns to Select Same & Different Cells ... Featured Features: Grid Focus  |  Design View  |  Big Formula Bar  |  Workbook & Sheet Manager | Resource Library (Auto Text)  |  Date Picker  |  Combine Worksheets  |  Encrypt/Decrypt Cells  |  Send Emails by List  |  Super Filter  |  Special Filter (filter bold/italic/strikethrough...) ... Top 15 Toolsets:  12 Text Tools (Add Text, Remove Characters ...)  |  50+ Chart Types (Gantt Chart ...)  |  40+ Practical Formulas (Calculate age based on birthday ...)  |  19 Insertion Tools (Insert QR Code, Insert Picture from Path ...)  |  12 Conversion Tools (Numbers to Words, Currency Conversion ...)  |  7 Merge & Split Tools (Advanced Combine Rows, Split Excel Cells ...)  |  ... and more

Kutools for Excel Boasts Over 300 Features, Ensuring That What You Need is Just A Click Away...

#### Office Tab - Enable Tabbed Reading and Editing in Microsoft Office (include Excel)

• One second to switch between dozens of open documents!
• Reduce hundreds of mouse clicks for you every day, say goodbye to mouse hand.
• Increases your productivity by 50% when viewing and editing multiple documents.
• Brings Efficient Tabs to Office (include Excel), Just Like Chrome, Edge and Firefox.