COUPDAYS

Returns the number of days in the coupon period that contains the settlement date.

If this function is not available, run the Setup program to install the Analysis ToolPak. After you install the Analysis ToolPak, you must enable it by using the Add-Ins command on the Tools menu.

Syntax

COUPDAYS(settlement,maturity,frequency,basis)

Settlement   is the security's settlement date. The security settlement date is the date after the issue date when the security is traded to the buyer.

Maturity   is the security's maturity date. The maturity date is the date when the security expires.

Frequency   is the number of coupon payments per year. For annual payments, frequency = 1; for semiannual, frequency = 2; for quarterly, frequency = 4.

Basis   is the type of day count basis to use.

Remarks

• The settlement date is the date a buyer purchases a coupon, such as a bond. The maturity date is the date when a coupon expires. For example, suppose a 30-year bond is issued on January 1, 1996, and is purchased by a buyer six months later. The issue date would be January 1, 1996, the settlement date would be July 1, 1996, and the maturity date is January 1, 2026, 30 years after the January 1, 1996 issue date.
• All arguments are truncated to integers.
• If any argument is nonnumeric, COUPDAYS returns the #VALUE! error value.
• If settlement or maturity is not a valid date, COUPDAYS returns the #NUM! error value.
• If frequency is any number other than 1, 2, or 4, COUPDAYS returns the #NUM! error value.
• If basis < 0 or if basis > 4, COUPDAYS returns the #NUM! error value.
• If settlement ³ maturity, COUPDAYS returns the #NUM! error value.

Example

A bond has the following terms:

January 25, 1993, settlement date
November 15, 1994, maturity date
Semiannual coupon
Actual/actual basis

The number of days in the coupon period that contains the settlement date (in the 1900 date system) is:

COUPDAYS("1/25/93","11/15/94",2,1) equals 181