Formualizer Docs
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.
  • rate is coupon rate (annual decimal), pr is price per 100 face value, and redemption is redemption per 100; pr and redemption must be positive.
  • frequency must be 1 (annual), 2 (semiannual), or 4 (quarterly).
  • basis codes: 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.05 means 5%).
  • This implementation uses Newton-Raphson iteration; if it cannot converge, it returns #NUM!.

Examples

Par price implies coupon-rate yield
Grid
CellValue
No inputs on Sheet1.
Formula
=
Result
Not evaluated yet.
Expected
0.05
Yield recovered from a discounted price
Grid
CellValue
No inputs on Sheet1.
Formula
=
Result
Not evaluated yet.
Expected
0.06

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

arg1

Number · Scalar · coercion NumberLenientText

arg2

Number · Scalar · coercion NumberLenientText

arg3

Number · Scalar · coercion NumberLenientText

arg4

Number · Scalar · coercion NumberLenientText

arg5

Number · Scalar · coercion NumberLenientText

arg6

Number · Scalar · coercion NumberLenientText

arg7

Number · Scalar · coercion NumberLenientText

Caps

PURE

Source

On this page