returns the yield of a security paying periodic interest · from excel · excel: verified match · sheets: verified match

signature

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

returns: number

argument	required
settlement	required
maturity	required
rate	required
pr	required
redemption	required
frequency	required
basis	optional

examples

formula and result, taken from the engine's own test suite — every result below is asserted in CI, not written by hand.

errors

error values observed from the engine — each with a call that produces it.

error	produced by
#ERROR!	=YIELD(1, 2, 3, 4, 5)

related

• ACCRINT accrued interest for a security paying periodic interest
• ACCRINTM accrued interest for a security paying at maturity
• AMORDEGRC depreciation per period, French accounting, degressive
• AMORLINC depreciation per period, French accounting, linear
• COUPDAYBS days from coupon period start to settlement
• COUPDAYS days in the coupon period containing settlement