# COUPDAYS

## Content

This function returns the number of days in the coupon period that contains the settlement date.

## Syntax

`COUPDAYS(settlement, maturity, frequency, [basis])`

## Arguments

This function has these arguments:

| Argument | Description |
| -------- | ----------- |
| *settlement* | [Required] Settlement date for the security |
| *maturity* | [Required] Maturity date for the security |
| *frequency* | [Required] Frequency of payment, number of coupon payments per year; must be 1, 2, or 4 |
| *basis* | [Optional] Integer representing the basis for day count |

## Remarks

This function returns an error if *settlement* or *maturity* is invalid (#VALUE!), or if *frequency* is a number other than 1, 2, or 4 (#NUM!). All arguments are truncated to integers.

* If *basis* is greater than 4 or less than 0, a #NUM! error is returned.
* If *settlement* is greater than or equal to maturity, a #NUM! error is returned.

## Examples

`COUPDAYS(A1,A2,A3,A4)`