# YIELD

Spread for WinForms provides advanced software components that support Excel import/export, full cell customization, an extensive calculation engine with over 450 functions and more, all with zero dependencies on Excel.

## Content



This function calculates the yield on a security that pays periodic interest.

## Syntax

YIELD(*settle*,*maturity*,*rate*,*price*,*redeem*,*frequency*,*basis*)

## Arguments

This function has these arguments:

| **Argument** | **Description** |
| -------- | ----------- |
| *settle* | Settlement date for the security |
| *maturity* | Maturity date for the security |
| *rate* | Annual coupon rate |
| *price* | Price per $100 face value for the security |
| *redeem* | Redemption value per $100 face value |
| *frequency* | Frequency of payment, number of coupon payments per year; must be 1, 2, or 4 |
| *basis* | [Optional] Integer representing the basis for day count (Refer to [Day Count Basis](/spreadnet/docs/latest/online-formula/formulas-overview/formulas-functs/formulas-functtypes/formulas-functsfinance/formulas-functsdaycount).) |

## Remarks

This function returns a #VALUE! error when settle or maturity is invalid. A #NUM! error is returned if frequency is a number other than 1, 2, or 4. If rate is less than 0, a #NUM! error is returned. If price or redeem is less than or equal to 0, a #NUM! error is returned. If basis is less than 0 or greater than 4, a #NUM! error is returned. If settle is greater than or equal to maturity, a #NUM! error is returned. Settle, maturity, frequency, and basis are truncated to integers.

## Data Types

Accepts numeric data and dates. Returns numeric data.

## Examples

`YIELD(A1,A2,A3,A4,A5,A6,A7)`

## Version Available

This function is available in product version 2.0 or later.

## See Also

[YIELDDISC](/spreadnet/docs/latest/online-formula/formulas-functionsall/formulas-functsTtoZ/FunctionYIELDDISC) \| [YIELDMAT](/spreadnet/docs/latest/online-formula/formulas-functionsall/formulas-functsTtoZ/FunctionYIELDMAT) \| [ODDFYIELD](/spreadnet/docs/latest/online-formula/formulas-functionsall/formulas-functsMtoQ/FunctionODDFYIELD) \| [Financial Functions](/spreadnet/docs/latest/online-formula/formulas-overview/formulas-functs/formulas-functtypes/formulas-functsfinance)