<div class="raw-html-embed">The YIELD function is one of the <a href="https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-spreadsheet-editor/UsageInstructions/InsertFunction.aspx#financial" onclick="onhyperlinkclick(this)">financial functions</a>. It is used to calculate the yield of a security that pays periodic interest.
 <h5 class="pt8">Syntax</h5>
 YIELD(settlement, maturity, rate, pr, redemption, frequency, [basis])
 The YIELD function has the following arguments:
 <table style="width: 40%">
 <tbody><tr>
 <th style="background-color: #f4f4f4" width="150ch">Argument</th>
 <th style="background-color: #f4f4f4">Description</th>
 </tr>
 <tr>
 <td>settlement</td>
 <td>The date when the security is purchased.</td>
 </tr>
 <tr>
 <td>maturity</td>
 <td>The date when the security expires.</td>
 </tr>
 <tr>
 <td>rate</td>
 <td>The annual coupon rate of the security.</td>
 </tr>
 <tr>
 <td>pr</td>
 <td>The purchase price of the security, per $100 par value.</td>
 </tr>
 <tr>
 <td>redemption</td>
 <td>The redemption value of the security, per $100 par value.</td>
 </tr>
 <tr>
 <td>frequency</td>
 <td>The number of interest payments per year. The possible values are: 1 for annual payments, 2 for semiannual payments, 4 for quarterly payments.</td>
 </tr>
 <tr>
 <td>basis</td>
 <td>The day count basis to use, a numeric value greater than or equal to 0, but less than or equal to 4. It is an optional argument. The possible values are listed in the table below.</td>
 </tr>
 </tbody></table>
 The basis argument can be one of the following:
 <table style="width: 40%">
 <tbody><tr>
 <th style="background-color: #f4f4f4">Numeric value</th>
 <th style="background-color: #f4f4f4">Count basis</th>
 </tr>
 <tr>
 <td>0</td>
 <td>US (NASD) 30/360</td>
 </tr>
 <tr>
 <td>1</td>
 <td>Actual/actual</td>
 </tr>
 <tr>
 <td>2</td>
 <td>Actual/360</td>
 </tr>
 <tr>
 <td>3</td>
 <td>Actual/365</td>
 </tr>
 <tr>
 <td>4</td>
 <td>European 30/360</td>
 </tr>
 </tbody></table>
 <h5 class="pt8">Notes</h5>
 Dates must be entered by using the <a href="https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-spreadsheet-editor/Functions/date.aspx" onclick="onhyperlinkclick(this)">DATE</a> function.
 
 <a href="https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-spreadsheet-editor/UsageInstructions/InsertFunction.aspx#applyfunction" onclick="onhyperlinkclick(this)">How to apply</a> the YIELD function.
 
 <h5 class="pt8">Examples</h5>
 The figure below displays the result returned by the YIELD function.
 <img alt="YIELD Function" src="https://static-helpcenter.teamlab.info/yield_127e424fbf.png"></div>

YIELD function

Docs

Argument	Description
*settlement*	The date when the security is purchased.
*maturity*	The date when the security expires.
*rate*	The annual coupon rate of the security.
pr	The purchase price of the security, per $100 par value.
*redemption*	The redemption value of the security, per $100 par value.
*frequency*	The number of interest payments per year. The possible values are: 1 for annual payments, 2 for semiannual payments, 4 for quarterly payments.
*basis*	The day count basis to use, a numeric value greater than or equal to 0, but less than or equal to 4. It is an optional argument. The possible values are listed in the table below.

Numeric value	Count basis
0	US (NASD) 30/360
1	Actual/actual
2	Actual/360
3	Actual/365
4	European 30/360

YIELD function

Syntax

Notes

Examples

Host ONLYOFFICE Docs on your own server or use it in the cloud