YIELDMAT

annual yield of a security paying interest at maturity · from excel · excel: not yet compared · sheets: not yet compared

signature

YIELDMAT(settlement, maturity, issue, rate, pr, [basis])

returns: number

argumentrequired
settlement required
maturity required
issue required
rate required
pr 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.

fx =YIELDMAT(DATE(2026,1,15), DATE(2026,12,15), DATE(2025,6,1), 0.05, 99) 0.059649816994757215

errors

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

errorproduced by
#NUM! =YIELDMAT(2, 2, 2, 0.05, 2)

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