Exceljet

Quick, clean, and to the point

Excel YIELDMAT Function

Excel YIELDMAT function
Summary 
The Excel YIELDMAT function returns the annual yield of a security that pays interest at maturity.
Purpose 
Get annual yield of security interest at maturity
Return value 
Yield as percentage
Syntax 
=YIELDMAT (sd, md, id, rate, pr, [basis])
Arguments 
  • sd - Settlement date of the security.
  • md - Maturity date of the security.
  • id - Issue date of the security.
  • rate - Interest rate of security.
  • pr - Price per $100 face value.
  • basis - [optional] Coupon payments per year (annual = 1, semiannual = 2; quarterly = 4).
Usage notes 

The YIELDMAT function returns the annual yield of a security that pays interest at maturity. In the example shown, the formula in F5 is:

=YIELDMAT(C9,C7,C8,C6,C5,C10)

with these inputs, the YIELDMAT function returns 0.081 which, or 8.10% when formatted with the percentage number format.

Entering dates

In Excel, dates are serial numbers. Generally, the best way to enter valid dates is to use cell references, as shown in the example. If you want to enter valid dates directly inside a function, the DATE function is the best approach.

Basis

The basis argument controls how days are counted. The PRICE function allows 5 options (0-4) and defaults to zero, which specifies US 30/360 basis. This article on wikipedia provides a detailed explanation of available conventions.

Basis Day count
0 or omitted US (NASD) 30/360
1 Actual/actual
2 Actual/360
3 Actual/365
4 European 30/360

Notes

  • In Excel, dates are serial numbers
  • Settlement, maturity issue, and basis are truncated to integers
  • If settlement, maturity, or issue dates are not valid, YIELDMAT returns #VALUE!
  • YIELDMAT returns #NUM! if any of the following are true:
    • rate < 0
    • pr <= 0
    • settlement >= maturity
    • Basis is not 0-4

Excel Formula Training

Formulas are the key to getting things done in Excel. In this accelerated training, you'll learn how to use formulas to manipulate text, work with dates and times, lookup values with VLOOKUP and INDEX & MATCH, count and sum with criteria, dynamically rank values, and create dynamic ranges. You'll also learn how to troubleshoot, trace errors, and fix problems. Instant access. See details here.