Documentation/Calc Functions/YIELDMAT

Function name:
YIELDMAT

Category:
Financial Analysis

Summary:
Calculates the annual yield of a security, the interest of which is paid on the date of maturity.

Syntax:
YIELDMAT(Settlement; Maturity; Issue; Rate; Price[; Basis])

Returns:
Returns a real number (expressed as a percentage or fraction) which is the value of a security per 100 currency units of face value. The security has an irregular first interest date.

Arguments:
Settlement is a date or a reference to a cell containing that date which is the date of purchase of the security.

Maturity is a date or a reference to a cell containing that date which is the date on which the security matures (expires).

Issue is a date or a reference to a cell containing that date which is the date of issue of the security.

Rate is a non-negative real number (expressed as a percentage or fraction) or a reference to a cell containing that number which is the annual rate of interest (coupon interest rate).

Price is a positive real number or a reference to a cell containing that number which is the price (purchase price) of the security per 100 currency units of par value.


 * If Price less than or equal to 0 then the function returns an error value.
 * If either Maturity or Settlement is not valid dates then the function returns an value(#VALUE!) error.
 * If Settlement date is after the Maturity date then the function returns an error value.
 * If Rate is less than 0 then the function will return an error value.
 * If Basis is a non-integer value, then the function uses its floor value, i.e. it is truncated to an integer value.
 * After truncation if Basis is any number except 0,1,2,3,4 or missing (passed as empty argument or not passed at all),then the function will return an error value.

Additional details:
None

Related LibreOffice functions:
[[Special:MyLanguage/Documentation/Calc_Functions/PRICEMAT PRICEMAT]

[[Special:MyLanguage/Documentation/Calc_Functions/YIELD YIELD]

[[Special:MyLanguage/Documentation/Calc_Functions/YIELDDISC YIELDDISC]

ODF standard:
Section 6.12.55, part 2

Equivalent Excel functions:
YIELDMAT