YIELDMAT Function

Calculate yield for securities paying interest at maturity. Complete guide with examples, parameters, and common errors for YIELDMAT function.

ExcelExcel
Google SheetsGoogle Sheets
financial
intermediate
Syntax Preview
ExcelExcelGoogle SheetsGoogle Sheets
=YIELDMAT(settlement, maturity, issue, rate, pr, [basis])

Practical Examples

Basic Treasury Bill Yield Calculation

Calculate the yield for a 90-day treasury bill

Result: 0.0864 or 8.64%

Six-Month Commercial Paper Yield

Calculate yield for short-term corporate debt

Result: 0.0582 or 5.82%

Short-Term Municipal Bond Yield

Calculate yield for a tax-advantaged security

Result: 0.0512 or 5.12%

European Day Count Basis Calculation

Calculate yield using European 30/360 convention

Result: 0.0732 or 7.32%

Comparing Different Basis Methods

Show how day count conventions impact yield

Result: Basis 0 (30/360): ~0.0615 or 6.15% Basis 1 (Actual/actual): ~0.0619 or 6.19%

Common Errors and Solutions

#NUM!

YIELDMAT returns #NUM! error

Cause:

Invalid date sequence (issue must be before settlement, which must be before maturity), negative values for rate or pr, price less than or equal to 0, or invalid basis value

Solution:

Verify that issue date < settlement date < maturity date. Ensure all numeric parameters (rate, pr) are positive values. Check that the price (pr) is greater than 0 and the basis is between 0 and 4.

Prevention:

Add data validation to ensure dates are in proper sequence and all numeric inputs are positive. Use conditional formatting to flag potential issues before calculation.

Frequency: 45%

Example:

#VALUE!

YIELDMAT returns #VALUE! error

Cause:

One or more arguments is not a valid data type - dates are not valid Excel dates, or rate, pr, basis are not numbers

Solution:

Ensure all date parameters are valid Excel dates. Use the DATE function instead of text strings. Verify that rate and pr are numeric values, not text. Remove any currency symbols or percentage signs from the rate and price values.

Prevention:

Always use DATE() function for date inputs. Format cells properly before calculations. Use VALUE() to convert text to numbers if necessary.

Frequency: 30%

Example:

#NUM! (Price)

YIELDMAT returns #NUM! for price issues

Cause:

Price (pr) is less than or equal to 0

Solution:

The pr parameter must be a positive number representing the price per $100 face value. Even heavily discounted securities should have a price above 0. Check for formula errors or cell references that might be producing zero or negative values.

Prevention:

Add input validation to ensure price is always positive. Use data validation rules: price > 0 and typically price should be between 50 and 150 for realistic securities.

Frequency: 15%

Example:

#NUM! (Basis)

YIELDMAT returns #NUM! for invalid basis

Cause:

Invalid basis value (must be 0-4)

Solution:

The basis parameter accepts only values 0, 1, 2, 3, or 4. If you specify a basis, ensure it's one of these valid options. When in doubt, omit the basis parameter to use the default value of 0.

Prevention:

Use data validation with a list of acceptable basis values (0, 1, 2, 3, 4). Document which basis is appropriate for your security type.

Frequency: 10%

Example:

Best Practices and Advanced Tips

Always Use DATE Function

Use DATE(year, month, day) instead of text dates to avoid regional format issues and ensure accuracy across different Excel versions. For example, use DATE(2024,4,1) instead of "4/1/2024" or "1/4/2024". This prevents ambiguity between US and European date formats and ensures your formulas work correctly when shared internationally.

Understand Day Count Basis

Choose the correct basis parameter based on your market convention: US securities typically use 0 (30/360), money market instruments use 2 (Actual/360), and some international bonds use 1 (Actual/actual) or 4 (European 30/360). Using the wrong basis can lead to yield calculations that don't match market standards, making comparisons inaccurate.

Date Sequence Matters

Ensure issue date < settlement date < maturity date. Excel will return #NUM! error if this sequence is violated. The issue date must be when the security was originally created, the settlement date is when you purchased it, and the maturity date is when it expires. Logically, you cannot purchase a security before it was issued, and it cannot mature before you purchased it.

Convert to Percentage

YIELDMAT returns a decimal value (e.g., 0.0864 for 8.64%). Multiply by 100 or format cells as percentage to display in familiar format. In Excel, select the cell and press Ctrl+Shift+% or use the Percentage button in the Home tab. This makes yield comparisons more intuitive and aligns with standard financial reporting practices.

Compare with Market Rates

Use YIELDMAT results to compare against prevailing market rates to identify over/undervalued securities. If your calculated yield is significantly higher than comparable securities, the investment may be underpriced (good buying opportunity). Conversely, a lower yield might indicate overpricing. Always consider credit risk and other factors when making investment decisions.

YIELDMAT vs YIELD vs YIELDDISC

Use YIELDMAT for securities that pay interest at maturity (treasury bills, commercial paper), YIELD for bonds with periodic coupon payments, and YIELDDISC for pure discount securities with no interest payments. Using the wrong function will produce incorrect yield calculations.

Treasury Bill Convention

US treasury bills typically use basis 2 (Actual/360), which counts the actual number of days and assumes a 360-day year. This is the money market convention in the United States. Always use the correct basis for your security type to ensure accurate yield calculations.

Verify Results

The calculated yield should be higher than the stated rate when the security trades at a discount (price < 100) and lower when it trades at a premium (price > 100). This fundamental relationship helps validate your YIELDMAT calculations.

Need Help with YIELDMAT Function?

Stop struggling with formula syntax. Use AskFormulas to generate validated formulas instantly with our AI-powered tool.

Example Excel formula:

Related Formulas

Excel PRICEDISC Function

Calculate the price of discounted securities. Learn PRICEDISC syntax, examples, and how to value Treasury bills and discount bonds effectively.

advanced
financial
ExcelExcel
Google SheetsSheets
Validated
Excel PRICEMAT Function

Calculate the price of securities that pay interest at maturity. Learn PRICEMAT syntax, examples, and how to value Treasury bills and bonds effectively.

intermediate
financial
ExcelExcel
Google SheetsSheets
Validated
YIELD Function

Calculate bond yields in Excel and Sheets. Learn the YIELD function syntax, parameters, examples, and common errors with this comprehensive guide.

intermediate
financial
ExcelExcel
Google SheetsSheets
Validated
YIELDDISC Function

Calculate discount security yields in Excel and Sheets. Learn YIELDDISC syntax, examples for Treasury bills, and common errors.

advanced
financial
ExcelExcel
Google SheetsSheets
Validated