Manuals/calci/RECEIVED

RECEIVED(SettlementDate, MaturityDate, Investment, Discount, Basis)

• where, $SettlementDate$ is the security's settlement date (a date when coupon or a bond is purchased)
• $MaturityDate$ is the security's maturity date (a date when coupon or a bond expires)
• $Investment$ is the amount invested in security
• $Discount$ is the security's discount rate
• $Basis$ is the type of day count basis to use

RECEIVED() calculates the amount received at maturity for a fully invested security.

Description

• $SettlementDate$ and $MaturityDate$ dates should be entered either in 'date format' or 'dates returned using formulas'. If dates are not valid, Calci displays #N/A error message.
• If $SettlementDate$ >= Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle MaturityDate} , Calci displays #N/A error message.
• If Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Investment} <=0 or Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Discount} <=0, Calci displays #N/A error message.
• Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis} value is optional. If omitted, Calci assumes it to be 0.

Below table shows the use of Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis} values:

Basis	Description
0	US (NASD) 30/360
1	Actual/actual
2	Actual/360
3	Actual/365
4	European 30/365

• If Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle Basis} value is other than 0 to 4, Calci displays #N/A error message.
• Formula:

If 'B' is number of days in a year, and 'D' is number of days from 'Settlement' to Maturity', the RECEIVED is calculated as -

Failed to parse (MathML with SVG or PNG fallback (recommended for modern browsers and accessibility tools): Invalid response ("Math extension cannot connect to Restbase.") from server "https://wikimedia.org/api/rest_v1/":): {\displaystyle RECEIVED = \frac{Investment}{1-(Discount X \frac{D}{B})}}

Examples

Consider the following example that shows the use of RECEIVED function:

4/24/2010		1/1/2013
7/24/2010		1/1/2014
1550000		50000
4.65%		6%
2

=RECEIVED(A1,A2,A3,A4,A5) displays 1568435.6540840461 as a result.
=RECEIVED(C1,C2,C3,C4) displays 53191.48936170212 as a result.

Related Videos

BOND AND INTEREST RATE

See Also

• INTRATE

References

• Maturity
• Day Count Basis

• List of Main Z Functions

• Z3 home