The Excel YIELDMAT function calculates the annual yield of a security that pays interest at maturity.
The syntax of the function is:
Where the arguments are as follows:
| settlement | - | The settlement date of the security (i.e. the date that the coupon is purchased). | ||||||||||||
| maturity | - | The maturity date of the security (i.e. the date that the coupon expires). | ||||||||||||
| issue | - | The issue date of the security. | ||||||||||||
| rate | - | The security's interest rate at date of issue. | ||||||||||||
| pr | - | The security's price per $100 face value. | ||||||||||||
| [basis] | - |
An optional integer argument which specifies the financial day count basis that is used by the security. Possible values are:
|
Note that the date arguments must satisfy the following:
Also, the settlement, maturity and issue date arguments should be supplied to the function as either:
Warning: If you attempt to enter text representations of dates into Excel functions, these can be interpreted differently, depending on the date system and date interpretation settings on your computer.
In the following spreadsheet, the Excel Yieldmat function is used to calculate the annual yield for a security purchased on 01-Jan-2017, with issue date 01-Jul-2014 and maturity date 30-Jun-2018. The interest rate at date of issue is 5.5% and the security has a price of $101 per $100 face value. The US (NASD) 30/360 day count basis is used:
| A | B | |
|---|---|---|
| 1 | Settlement Date: | 01-Jan-2017 |
| 2 | Maturity Date: | 30-Jun-2018 |
| 3 | Issue Date: | 01-Jul-2014 |
| 4 | =YIELDMAT( B1, B2, B3, 5.5%, 101 ) | |
The above Yieldmat function calculates the yield to be 4.21%.
Note that, in the above example:
For further examples of the Excel Yieldmat function, see the Microsoft Office website.
If you get an error from the Yieldmat function, this is likely to be one of the following:
| #NUM! | - |
Occurs if either:
|
| #VALUE! | - |
Occurs if either:
|