YIELDMAT Function
Calculate yield for securities paying interest at maturity. Complete guide with examples, parameters, and common errors for YIELDMAT function.
=YIELDMAT(settlement, maturity, issue, rate, pr, [basis])Quick Answer
YIELDMAT function YIELDMAT function calculates the annual yield of a security that pays interest at maturity, commonly used for treasury bills and other short-term securities. The syntax is `=YIELDMAT(settlement, maturity, issue, rate, pr, [basis])` where settlement is the purchase date, maturity is when the security expires, issue is the original issue date, rate is the interest rate, pr is the price per $100 face value, and basis is the day count method (optional, defaults to 0 for US 30/360).
=YIELDMAT(settlement, maturity, issue, rate, pr, [basis])- Example: `=YIELDMAT(DATE(2024,4,1), DATE(2024,7,1), DATE(2024,1,15), 0.0525, 98.75, 2)` returns 0.0864 or 8.64%.
Practical Examples
Basic Treasury Bill Yield Calculation
Calculate the yield for a 90-day treasury bill
Six-Month Commercial Paper Yield
Calculate yield for short-term corporate debt
Short-Term Municipal Bond Yield
Calculate yield for a tax-advantaged security
European Day Count Basis Calculation
Calculate yield using European 30/360 convention
Comparing Different Basis Methods
Show how day count conventions impact yield
Common Errors and Solutions
YIELDMAT returns #NUM! error
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
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.
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.
Example:
YIELDMAT returns #VALUE! error
One or more arguments is not a valid data type - dates are not valid Excel dates, or rate, pr, basis are not numbers
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.
Always use DATE() function for date inputs. Format cells properly before calculations. Use VALUE() to convert text to numbers if necessary.
Example:
YIELDMAT returns #NUM! for price issues
Price (pr) is less than or equal to 0
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.
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.
Example:
YIELDMAT returns #NUM! for invalid basis
Invalid basis value (must be 0-4)
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.
Use data validation with a list of acceptable basis values (0, 1, 2, 3, 4). Document which basis is appropriate for your security type.
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
Calculate the price of discounted securities. Learn PRICEDISC syntax, examples, and how to value Treasury bills and discount bonds effectively.
Calculate the price of securities that pay interest at maturity. Learn PRICEMAT syntax, examples, and how to value Treasury bills and bonds effectively.
Calculate bond yields in Excel and Sheets. Learn the YIELD function syntax, parameters, examples, and common errors with this comprehensive guide.
Calculate discount security yields in Excel and Sheets. Learn YIELDDISC syntax, examples for Treasury bills, and common errors.