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

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

    Syntax

    COUPNUM(settlement,maturity,frequency,basis)

    Arguments

    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.)

    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.

    Data Types

    Accepts numeric and DateTime object data. Returns numeric data.

    Examples

    COUPNUM(A1,A2,A3,A4)

    COUPNUM(R6C3:R9C4)

    Version Available

    This function is available in product version 2.0 or later.

    See Also

    COUPDAYS | Financial Functions