TimeValue
TimeValue[s,i,t]
calculates the time value of a security s at time t for an interest specified by i.
Details and Options
 TimeValue[a, i, t] for a simple amount a and a positive time value t gives the future or accumulated value of a for an effective interest rate i at the time t. »
 TimeValue[a, i, t] for a simple amount a and a negative time value t gives the present or discounted value of a for an effective interest rate i. »
 TimeValue works with arbitrary numeric or symbolic expressions. Symbolic formulas returned by TimeValue can be solved for interest rates, payments or time periods using builtin functions such as Solve and FindRoot.
 The security s can have the following additional forms and interpretations:

Annuity series of payments at the end of periods » AnnuityDue series of payments at the beginning of periods Cashflow stream of cashflow »  TimeValue[Annuity[…],interest,t] computes the time value of an annuity as a single equivalent payment at time t. Possible annuity calculations include mortgage valuation, bond pricing and payment or yield computations.
 TimeValue[Cashflow[…],interest,t] computes the time value of a cash flow as a single equivalent payment at time t. Possible cash flow calculations include net present value, discounted cash flow and internal rate of return.
 TimeValue[s,i,{t,t_{1}}] computes the time value accumulated or discounted from time t_{1} to t using interest i. Time t_{1} serves as a reference point for cash flow occurrences. »
 TimeValue[s,i] is equivalent to TimeValue[s,i,0].
 TimeValue[…,t] is equivalent to TimeValue[…,{t,0}].
 In TimeValue[s,i,t], the interest i can be specified in the following forms:

r effective interest rate {r_{1},r_{2},…} schedule of rates applied over unit time intervals » {{t_{1},r_{1}},{t_{2},r_{2}},…} schedule of rates changing at the specified time » {p_{1}>r_{1},p_{2}>r_{2},…} term structure of effective interest rates » function force of interest, given as a function of time » EffectiveInterest[…] an EffectiveInterest object »  TimeValue[s,EffectiveInterest[r,1/n],t] uses a nominal interest rate r, compounded n times per unit period. If times are specified as concrete dates, all interest rates are assumed to be annual rates.
 TimeValue[s,{r_{1},r_{2},…},…] gives the time value of an asset s for an interest rate schedule {r_{1},r_{2},…}, where the r_{i} are interest rates for consecutive unit periods.
 {r_{0},{t_{1},r_{1}},{t_{2},r_{2}},…} specifies an interest rate in effect before time t_{1}. This is equivalent to {{Infinity,r_{0}},{t_{1},r_{1}},{t_{2},r_{2}},…}.
 TimeValue[security,{r_{1},r_{2},…},t] is equivalent to TimeValue[security,{{0,r_{1}},{1,r_{2}},…},t].
 TimeValue[a,f,{t,t_{1}}] gives the time value of the simple amount a based on the force of interest function f, which corresponds to the growth or decay process given by .
 A force of interest specification can be used with any security type.
 The following options can be given:

Assumptions $Assumptions assumptions made about parameters GenerateConditions False whether to generate conditions on parameters
Examples
open allclose allBasic Examples (10)
Future value of $1000 at an effective interest rate of 5% after 3 compounding periods:
Present value of $1000 at 5% over 3 periods:
Future value of $1000 using a nominal rate of 5% with quarterly compounding:
Present value at 6% of a 12period annuity with payments of $100:
Future value at 6% of a series of cash flows occurring at regular intervals:
Future value in three years' time of $1000 invested on January 1, 2010, at 7.5%:
Future value after 5 periods using a schedule of rates over unit time intervals:
Present value using a schedule of rates effective at the specified times:
Future value using a schedule of rates over irregular time intervals:
Present value of an amount paid at time 10 using a term structure of interest rates:
Compute the future value after three time periods using a force of interest :
Scope (14)
Symbolic time value computations:
Time value computation using a rate schedule:
Time value based on a force of interest function:
A symbolic cash flow computation:
A symbolic annuity calculation:
Number of periods required to grow $1000 to $3000 at a 6% interest rate:
Symbolic solution for the number of periods:
Solve an annuity calculation for the payment amount:
An annuity with a continuous payment flow can be coupled with a force of interest specification:
Hours, minutes, and seconds can be given in date specifications:
Rates can be given as a TimeSeries:
Options (2)
Applications (15)
Find the amount that must be invested at a rate of 9% per year in order to accumulate $1000 at the end of 3 years:
Find the accumulated value of $5000 over 5 years at 8% compounded quarterly:
Find how much time it will take $1000 to accumulate to $1500 if invested at 6%, compounded semiannually:
Find the future value of 1 at the end of n years if the force of interest is , where t is time:
Find an expression for the accumulated value of $1000 at the end of 15 years if the effective interest rate is r_{1} for the first 5 years, r_{2} for the second 5 years, and r_{3} for the third 5 years:
If you invest $1000 at 8% per year compounded quarterly, find how much can be withdrawn at the end of every quarter to use up the fund exactly at the end of 10 years:
Find the rate, compounded quarterly, at which $16000 is the present value of a $1000 payment paid at the end of every quarter for 5 years:
Find the accumulated value of a 10year annuity of $100 per year if the effective rate of interest is 5% for the first 6 years and 4% for the last 4 years:
Find the net present value of a $1000 initial investment producing future incoming cash flows:
Find the internal rate of return of an investment with regular cash flows:
In return for receiving $600 at the end of 8 years, a person pays $100 immediately, $200 at the end of 5 years, and a final payment at the end of 10 years. Find the final payment amount that will make the rate of return on the investment equal to 8% compounded semiannually:
Payments of $100, $200, and $500 are due at the end of years 2, 3, and 8, respectively. Find the point in time where a payment of $800 would be equivalent at 5% interest:
Another method to solve the problem above:
Find the effective rate of interest at which the present value of $2000 at the end of 2 years and $3000 at the end of 4 years will be equal to $4000:
Since a loan's balance at any time is equal to the present value of its remaining future payments, Annuity can be used to create an amortization table:
Properties & Relations (2)
Possible Issues (3)
When finding interest rate solutions to longterm or highfrequency annuities or bonds, FindRoot may be needed instead of Solve:
In order for TimeValue to determine if there are enough rates in a schedule to reach the valuation period, the valuation period must be numeric:
Input numeric valuation period:
Specifying rates by a TimeSeries requires the first time to be 0:
Interactive Examples (1)
Use Manipulate to explore the various dependencies a series of cash flows has on a set of variables:
Text
Wolfram Research (2010), TimeValue, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeValue.html (updated 2024).
CMS
Wolfram Language. 2010. "TimeValue." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2024. https://reference.wolfram.com/language/ref/TimeValue.html.
APA
Wolfram Language. (2010). TimeValue. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TimeValue.html