ReferenceFunctionsFinancial Functions
YIELD
Returns annual yield for a coupon-paying security from its market price.
Summary
YIELD solves for the annual rate that makes PRICE(...) match the input pr.
Remarks
- Date inputs are spreadsheet serial dates and must satisfy
maturity > settlement. rateis coupon rate (annual decimal),pris price per 100 face value, andredemptionis redemption per 100;prandredemptionmust be positive.frequencymust be1(annual),2(semiannual), or4(quarterly).basiscodes:0=US(NASD)30/360,1=Actual/Actual,2=Actual/360,3=Actual/365,4=European30/360.- Result is an annualized decimal yield (for example,
0.05means 5%). - This implementation uses Newton-Raphson iteration; if it cannot converge, it returns
#NUM!.
Examples
Par price implies coupon-rate yield
Grid
| Cell | Value | |
|---|---|---|
| No inputs on Sheet1. | ||
Formula
=
Result
Not evaluated yet.
Expected
0.05
Yield recovered from a discounted price
Grid
| Cell | Value | |
|---|---|---|
| No inputs on Sheet1. | ||
Formula
=
Result
Not evaluated yet.
Expected
0.06
Related functions
FAQ
What does the returned YIELD represent?
It is an annualized decimal yield (for example, 0.06 means 6% per year).
When does YIELD return #NUM! besides invalid inputs?
The Newton-Raphson solve can fail to converge or hit an unstable derivative; in those cases it returns #NUM!.
Runtime metadata
Category
Financial
Signature
YIELD(arg1: Number, arg2: Number, arg3: Number, arg4: Number, arg5: Number, arg6: Number, arg7…: Number)Arity
min 6, max variadic
Arguments
arg1Number · Scalar · coercion NumberLenientText
arg2Number · Scalar · coercion NumberLenientText
arg3Number · Scalar · coercion NumberLenientText
arg4Number · Scalar · coercion NumberLenientText
arg5Number · Scalar · coercion NumberLenientText
arg6Number · Scalar · coercion NumberLenientText
arg7Number · Scalar · coercion NumberLenientText
Caps
PURE
Source