YIELD

This function calculates the yield on a security that pays periodic interest.

Syntax

YIELD(settle,maturity,rate,price,redeem,frequency,basis)

Arguments

This function has these arguments:

Argument	Description
settle	Settlement date for the security
maturity	Maturity date for the security
rate	Annual coupon rate
price	Price per $100 face value for the security
redeem	Redemption value per $100 face value
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 a #VALUE! error when settle or maturity is invalid. A #NUM! error is returned if frequency is a number other than 1, 2, or 4. If rate is less than 0, a #NUM! error is returned. If price or redeem is less than or equal to 0, a #NUM! error is returned. If basis is less than 0 or greater than 4, a #NUM! error is returned. If settle is greater than or equal to maturity, a #NUM! error is returned. Settle, maturity, frequency, and basis are truncated to integers.

Data Types

Accepts numeric data and dates. Returns numeric data.

Examples

YIELD(A1,A2,A3,A4,A5,A6,A7)

Version Available

This function is available in product version 2.0 or later.