Skip to main content
← All functions

YIELD function

Returns the yield on a security that pays periodic interest

Syntax

YIELD(settlement, maturity, rate, pr, redemption, frequency, [basis])

Square brackets indicate optional arguments.

Arguments

ArgumentRequiredMeaning
settlementYesThe security's settlement date."2008-11-11"
maturityYesThe security's maturity date."2021-3-1"
rateYesThe security's interest rate.7.85%
prYesThe security's price per $100 face value.98.45
redemptionYesThe security's redemption value per $100 face value.100
frequencyYesThe number of coupon payments per year. For annual payments, frequency = 1; for semiannual, frequency = 2; for quarterly, frequency = 4.2
basisNoThe type of day count basis to use.1

Try YIELD

Recover a deep-discount quarterly yield

=YIELD(DATE(2026,1,15),DATE(2056,1,15),A2,B2,C2,D2,E2)

The independently authored zero-coupon quote is 100 divided by (1+0.5/frequency) raised to 30×frequency. The implied annual yield is 0.5. A fixed absolute price stopping threshold is too coarse for this small quote.

Inspect the current formula

Read its written arguments or observe actual operation values in a separate local calculation. This action neither applies a draft nor grades an answer.

Read the formula, one argument at a time

Explore the written function calls and their inputs. The calculation result belongs to the complete formula.

YIELD · top-level call

=YIELD(DATE(2026,1,15),DATE(2056,1,15),A2,B2,C2,D2,E2)

1 / 7 · settlement

The security's settlement date.

YIELD reference ↗

Follow the cells behind a result

Read explicit local references and helper formulas using a separate calculation. Your draft stays in this field; the worksheet and practice checks do not change.

The worksheet runs locally. Published checks apply to the supplied example only. Native Excel and Google Sheets compatibility remain unverified.

Practice a complete task

Reference and compatibility

Univer 1.0.4 / Apache-2.0. Calculation checks cover the supplied examples only. The browser worksheet does not implement every Excel feature, external service or connected data type.