WOLFRAM

Enable JavaScript to interact with content and submit forms on Wolfram websites. Learn how
Wolfram Language & System Documentation Center

TimeValue [s,i,t]

calculates the time value of a security s at time t for an interest specified by i.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
Assumptions  
GenerateConditions  
Applications  
Properties & Relations  
Possible Issues  
Interactive Examples  
See Also
Related Guides
History
Cite this Page

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 built-in 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,t1}] computes the time value accumulated or discounted from time t1 to t using interest i. Time t1 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
    {r1,r2,} schedule of rates applied over unit time intervals »
    {{t1,r1},{t2,r2},} schedule of rates changing at the specified time »
    {p1->r1,p2->r2,} term structure of effective interest rates »
    function force of interest, given as a function of time »
  • 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,{r1,r2,},] gives the time value of an asset s for an interest rate schedule {r1,r2,}, where the ri are interest rates for consecutive unit periods.
  • {r0,{t1,r1},{t2,r2},} specifies an interest rate in effect before time t1. This is equivalent to {{-Infinity ,r0},{t1,r1},{t2,r2},}.
  • TimeValue [security,{r1,r2,},t] is equivalent to TimeValue [security,{{0,r1},{1,r2},},t].
  • TimeValue [a,f,{t,t1}] 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 all close all

Basic Examples  (4)

Future value of 1000ドル at an effective interest rate of 5% after 3 compounding periods:

Present value of 1000ドル at the same interest rate of 5% after 3 compounding periods:

Present value at 6% of a 12-period annuity with payments of 100ドル:

Future value at 6% of a series of cash flows occurring at regular intervals:

Present value of an amount paid at time 10 using a term structure of interest rates:

Scope  (20)

Future value of 1000ドル using a nominal rate of 5% with quarterly compounding:

Symbolic time value computations:

Time value computation using a rate schedule:

Present value using a schedule of rates effective at the specified times:

Future value using a schedule of rates over irregular time intervals:

Time value based on a force of interest function:

Valuation of cash flows:

A symbolic cash flow computation:

Valuation of annuities:

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 for the interest rate:

Solve an annuity calculation for the payment amount:

Compute the future value after three time periods using a force of interest :

An annuity with a continuous payment flow can be coupled with a force of interest specification:

Future value in three years' time of 1000ドル invested on January 1, 2010, at 7.5%:

Hours, minutes, and seconds can be given in date specifications:

Future value after 5 periods using a schedule of rates over unit time intervals:

Rates can be given as a TimeSeries :

Options  (2)

Assumptions  (1)

Assumptions can be specified to simplify an expression or to carry out an integration or summation:

GenerateConditions  (1)

Some solutions may only be conditionally convergent:

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 r1 for the first 5 years, r2 for the second 5 years, and r3 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 10-year 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:

Graph the principal payoff over time:

Properties & Relations  (2)

Present value using a schedule of rates over irregular time intervals:

This is equivalent to:

Use Plot and Plot3D to show the dependencies of an annuity on a set of parameters:

Dependence on interest rate:

Dependence on payment growth rate:

Use Plot3D to view the interest rate/growth rate landscape:

Possible Issues  (3)

When finding interest rate solutions to long-term or high-frequency 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:

Shift the time series:

Interactive Examples  (1)

Use Manipulate to explore the various dependencies a series of cash flows has on a set of variables:

Wolfram Research (2010), TimeValue, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeValue.html (updated 2024).

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

BibTeX

@misc{reference.wolfram_2025_timevalue, author="Wolfram Research", title="{TimeValue}", year="2024", howpublished="\url{https://reference.wolfram.com/language/ref/TimeValue.html}", note=[Accessed: 17-November-2025]}

BibLaTeX

@online{reference.wolfram_2025_timevalue, organization={Wolfram Research}, title={TimeValue}, year={2024}, url={https://reference.wolfram.com/language/ref/TimeValue.html}, note=[Accessed: 17-November-2025]}

Top [フレーム]

AltStyle によって変換されたページ (->オリジナル) /