Spread Formula Reference
Formula Functions / Functions A to C / COUPNUM
In This Topic
    In This Topic

    This function returns the number of coupons due between the settlement date and maturity date.




    This function has these arguments:

    Argument Description
    settlement Settlement date for the security
    maturity Maturity date for the security
    frequency Frequency of payment, number of coupon payments per year; must be 1, 2, or 4
    basis [Optional] Integer representing the basis for day count (Refer to Day Count Basis.)


    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.

    Data Types

    Accepts numeric and DateTime object data. Returns numeric data.




    Version Available

    This function is available in product version 2.0 or later.

    See Also

    COUPDAYS | Financial Functions