Documentation/Calc Functions/YIELD

Function name:
YIELD

Category:
Financial Analysis

Summary:
Calculates the yield of a security.

Syntax:
YIELD(Settlement; Maturity; Rate; Price; Redemption; Frequency[; Basis])

Returns:
Returns a real number (expressed as a percentage or fraction) which is the yield of the security.

Arguments:
Settlement is a date or a reference to a cell containing that date which is the date of purchase of the security.

Maturity is a date or a reference to a cell containing that date which is the date on which the security matures (expires).

Rate is a non-negative real number (expressed as a percentage or fraction) or a reference to a cell containing that number which is the annual rate of interest (coupon interest rate).

Price is a positive real number or a reference to a cell containing that number which is the price (purchase price) of the security per 100 currency units of par value.

Redemption is a positive real number or a reference to a cell containing that number which is the redemption value per 100 currency units of par value.

Frequency is a positive integer or a reference to a cell containing that integer which is the number of interest payments per year (1, 2, or 4).


 * If Price less than or equal to 0 then the function returns an error value.
 * If either Maturity or Settlement is not valid dates then the function returns an value(#VALUE!) error.
 * If Settlement date is after the Maturity date then the function returns an error value.
 * If Rate is less than 0 then the function will return an error value.
 * If Redemption is less than or equal to 0 then the function returns an error value.
 * If Frequency, and Basis are non-integer values, then the function uses their floor value, i.e. they are truncated to an integer value.
 * After truncation if Frequency is any number except 1,2 or 4, then the function returns an error value.
 * After truncation if Basis is any number except 0,1,2,3,4 or missing (passed as empty argument or not passed at all),then the function will return an error value.

Additional details:
None

Related LibreOffice functions:
[[Special:MyLanguage/Documentation/Calc_Functions/PRICE PRICE]

[[Special:MyLanguage/Documentation/Calc_Functions/YIELDDISC YIELDDISC]

[[Special:MyLanguage/Documentation/Calc_Functions/YIELDMAT YIELDMAT]

ODF standard:
Section 6.12.53, part 2

Equivalent Excel functions:
YIELD