Documentation/Calc Functions/RECEIVED

Function name:
RECEIVED

Category:
Financial Analysis

Summary:
Calculates the amount received that is paid for fixed-interest security at a given point in time.

Syntax:
RECEIVED(Settlement; Maturity; Investment; Discount[; Basis])

Returns:
Returns a positive real number (in currency units) which is the amount received at maturity for a zero-coupon bond.

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).

Investment is a real number or a reference to the cell containing that number which is the purchase sum.

Discount is a positive real number (expressed as a percentage or a fraction) or a reference to the cell containing that number which is the discount of security as a percentage.


 * 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 Investment or Discount is less than or equal to 0 then the function returns an error value.
 * If Basis is a non-integer value, then the function uses their floor value, i.e. they are 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:

 * The formula for RECEIVED is:

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

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

ODF standard:
Section 6.12.43, part 2

Equivalent Excel functions:
RECEIVED