ForHosting KIT · 金融・お金

お金の時間的価値

Q: 利率はパーセントですか、小数ですか？

パーセントです。 年五パーセントなら 5 を送ってください。0.05 を送ると五パーセントではなく、パーセントの百分の五として扱われます。

Q: 年金、追加積立、一連のキャッシュフローは扱いますか？

扱いません。 離散複利で一つの一括を現在と将来のあいだで動かします。定期積立、系列の NPV、連続複利は別の恒等式です。ブラウザ用具は無料です。

1000を年5%、月複利で10年運用すると、120期で1647.01になります。現在価値に切り替えれば、将来受け取る金額が同じ利率で今いくらに当たるかが分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

計算モード: Future
元金: 1,000
金利: 5
頻度: 12
年数: 10

結果

値: 1,647.01
期間数: 120

お金の時間的価値とは、今日手元にある一ドルが、後で約束される一ドルと同じではないという考えです。投資した金は収益を生み、後から届く金は割り戻す必要があるからです。学習者、計画担当、製品チームは同じ二つの閉じた式に何度も出会います。将来価値は既知の元本に、年率を複利回数で割った値を一に足したものの、回数と年数の積乗を掛けたものです。現在価値はその同じ元本を同じ成長因子で割ったものです。この時間的価値の計算機は一括の元本、名目の年パーセント、年あたりの複利回数、年での地平、現在か将来かを選ぶ mode を受け取り、算出した value を返します。ローンの償却、一連のキャッシュフローの割引、利率の逆算、追加積立の予定は行いません。

お金の時間的価値の意味と二つの閉じた式の働き

お金の時間的価値は、今日の一括の現金と後の一括の現金が、示された利率と示された付利回数で増やしまたは割り戻して初めて比べられる、という教科書の恒等式です。将来価値は現在の元本を前方へ複利にします。FV は PV に一プラス r 割る n を、n 掛ける t 乗したものです。

現在価値はその逆です。 PV は FV を同じ因子で割ったもので、約束された将来額を今日の単位に書き直します。P はすでに分かっている一括です。将来価値を求めるときは今日の元本、現在価値を求めるときは将来額です。

r は名目年率の小数で、五パーセントの提示なら r は 0.05 です。n は複利回数、すなわち一年に何回利息を付けるかであり、t は年での地平です。よくある n は年一回、半年二回、四半期四回、月十二回、週五十二回、日三百六十五回です。

名目利率を固定したまま回数を増やすと、利息が早く働き始めるため将来価値はわずかに大きくなり、割引因子が大きくなるため現在価値はわずかに小さくなります。この能力は定期積立を足さず、手数料を引かず、e の r t 乗による連続複利へも切り替えません。それらは別の恒等式であり、別の検索意図です。

年数がゼロの地平は、有限の因子のゼロ乗が常に一であるため元の元本を返します。利率ゼロも元本を変えません。有限である限り負の利率も許され、入力ミスではなく契約上の減少を表します。

ただし一プラス r 割る n が使える底でなく、累乗が有限の実数でないとき、NaN を返す代わりにタスクは失敗します。

入力契約、応答の形、誤り時の振る舞い

mode は enum の future または present で、どの恒等式を評価するかを選びます。principal は単一通貨で既知の一括です。mode が future のときは PV、mode が present のときは FV です。

rate は名目の年パーセントで、五は年五パーセントを意味し、本当に万分の五を意図するのでなければ小数 0.05 ではありません。frequency は n、年あたりの複利回数で、一から三百六十五の正の整数でなければなりません。それが契約上の誤りです。

years は t、ゼロから百二十の有限数です。例：principal 千、五パーセント、年十二回、十年、mode future で periods は百二十、value は 1647.01 です。同じ元本を将来の一括として六パーセント四半期、五年、mode present で割り戻すと、より小さい現在価値になります。

検証失敗は残高を消費しません。

活用例

貯蓄目標と約束された満期一括

現在の一括を将来の目標まで増やし、または将来の満期一括を今日の単位へ割り戻します。元本、年パーセント、複利回数、年数から算出します。

教室と宿題の神託

FV = PV(1+r/n)^(nt) と PV = FV/(1+r/n)^(nt) の再現可能な解答キーを作り、整数でない複利回数は数字を捏造せず拒否します。

よくある質問

お金の時間的価値はどのように計算しますか？

将来価値は FV = PV × (1 + r/n)^(n×t) です。現在価値は PV = FV / (1 + r/n)^(n×t) です。P は既知の一括、r は小数の年率（パーセントを 100 で割った値）、n は年あたりの複利回数、t は年数です。

現在価値と将来価値の違いは何ですか？

将来価値は、今日お持ちの一括を後の日付まで増やします。現在価値は、後で受け取る一括を今日まで割り戻します。mode を future または present に設定してください。principal は前者では PV、後者では FV です。

複利回数が正の整数でないとどうなりますか？

frequency は 1 から 365 の整数でなければなりません（例：年 1、四半期 4、月 12）。ゼロ、分数、非数値は拒否され、課金されません。

利率はパーセントですか、小数ですか？

パーセントです。年五パーセントなら 5 を送ってください。0.05 を送ると五パーセントではなく、パーセントの百分の五として扱われます。

年金、追加積立、一連のキャッシュフローは扱いますか？

扱いません。離散複利で一つの一括を現在と将来のあいだで動かします。定期積立、系列の NPV、連続複利は別の恒等式です。ブラウザ用具は無料です。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/fin/time-value-of-money

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/fin/time-value-of-money \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"future","principal":1000,"rate":5,"frequency":12,"years":10}'

const res = await fetch("https://api.kit.forhosting.com/fin/time-value-of-money", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "mode": "future",
    "principal": 1000,
    "rate": 5,
    "frequency": 12,
    "years": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/time-value-of-money",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "mode": "future",
    "principal": 1000,
    "rate": 5,
    "frequency": 12,
    "years": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/time-value-of-money", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"mode":"future","principal":1000,"rate":5,"frequency":12,"years":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"mode":"future","principal":1000,"rate":5,"frequency":12,"years":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/time-value-of-money", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "mode": "future",
  "principal": 1000,
  "rate": 5,
  "frequency": 12,
  "years": 10
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.time_value_of_money",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

入力契約、応答の形、誤り時の振る舞い

必須の五欄を持つ JSON 本体を POST してください。alias の solve_for と direction を受け付けます。alias の amount、p、lump は同じ欄を指し、値はゼロ以上一兆以下です。alias の interest_rate、annual_rate、annual_percent は同じ欄を指します。frequency が欠落、整数でない、ゼロ、負、または三百六十五を超える場合、タスクは frequency を名指しして invalid_input で失敗し、課金されません。alias は n、compounds_per_year、compounding_frequency です。二点五のような端数年も許され、alias は t、time、period、time_period です。各数値欄は JSON の数でも数値文字列でも構いません。成功時は本体が mode、principal、rate、frequency、years を返し、periods を n 掛ける t として報告し、half-up で小数二桁に丸めた value と、FV が PV に一プラス r 割る n の n t 乗である旨、または逆の現在価値の恒等式を述べる formula 文字列を返します。成功した API 呼び出しは公開された基本料金 $0.002 を使います。

お金の時間的価値 API が役立つ場面

家計と学習者は、貯蓄目標、約束された満期一括、宿題が、示された年率と示された付利回数で一括が今日または後でいくらの価値かを問うとき、時間的価値の計算機を使います。家計指導の担当者は、正の整数でない複利回数を黙って NaN として成功扱いにする壊れたフォームではなく、それを拒否する決定的な神託を必要とします。要求を小さく保ち、丸めた value を試験に固定すれば、表計算サービスを自ら立てずにワークシート、LMS プラグイン、エッジワーカー向けの再現可能な現在と将来の数字が得られます。後で定期積立が必要になったら、この一括契約を引き伸ばすのではなく、年金の恒等式へ切り替えてください。製品チームは同じ契約を導入デモに結び、現在か将来かを選び、元本、パーセント、月次複利、地平を入れた利用者が、本番試験で API が後から返すのと同じ value を見るようにします。実装は段階 A の純粋 parse なので、成功した呼び出しは公開された基本料金 $0.002 で、モデルトークンも外向きネットワークもありません。

連携の活用例

製品デモと CI 用フィクスチャ

計画アプリと自動試験に、同じ五入力で無料ブラウザウィジェットとバイト単位で一致する決定的な value を与えます。

KITの完全なドキュメントを見る →

お金の時間的価値

無料で実行

計算例

お金の時間的価値の意味と二つの閉じた式の働き

入力契約、応答の形、誤り時の振る舞い

活用例

貯蓄目標と約束された満期一括

教室と宿題の神託

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

入力契約、応答の形、誤り時の振る舞い

お金の時間的価値 API が役立つ場面

連携の活用例

製品デモと CI 用フィクスチャ

ありがとう