Syntax
=YIELD(settlement, maturity, rate, pr, redemption, frequency, [basis])Arguments
| Argument | Required | Description |
|---|---|---|
settlement | Required | The settlement date |
maturity | Required | The maturity date |
rate | Required | The annual coupon rate |
pr | Required | The price per 100 face value |
redemption | Required | The redemption value per 100 face value |
frequency | Required | Coupon payments per year: 1, 2 or 4 |
basis | Optional | The day count basis, 0 to 4 |
How to use YIELD
YIELD takes 6 required arguments and 1 optional argument. Type =YIELD( in a cell and SheetsBat shows the arguments as you go. Optional arguments are shown in square brackets; leave them out to use their default.
Examples
Each result below was calculated by the SheetsBat formula engine.
=YIELD(DATE(2008,2,15), DATE(2016,11,15), 0.0575, 95.04287, 100, 2, 0)Result Related financial functions
- SYDReturns the sum of years' digits depreciation of an asset for a period.
- TBILLEQReturns the bond equivalent yield of a Treasury bill.
- TBILLPRICEReturns the price per 100 face value of a Treasury bill.
- TBILLYIELDReturns the yield of a Treasury bill.
- VDBReturns the declining balance depreciation of an asset between two periods, switching to straight line when that is larger.
- XIRRReturns the internal rate of return of cash flows that happen on given dates.
- XNPVReturns the net present value of cash flows that happen on given dates.
- YIELDDISCReturns the annual yield of a discounted security.
- YIELDMATReturns the annual yield of a security that pays interest at maturity.