年金支払額計算

現在の元金、期間ごとの利率、期間数が与えられたとき、残高をちょうど予定通りにゼロにする固定支払額はいくらかという問いです。閉形式の年金公式を適用し、支払額だけを返します。ローンの分割払いの見積もり、退職資金からの取り崩し額の算定、販売店が提示したリース見積もりの確認などにご利用いただけます。スプレッドシートも登録も不要な、決定的な一回の呼び出しです。

年金の支払額とは何か

年金とは、一定間隔で行われる等額支払いの流れを指します。毎月のローン返済、四半期ごとの年金の取り崩し、年間のリース料などがその例です。支払額とは、与えられた利率のもとで、その支払いの流れ全体を現在の元金と等価にする金額です。

その背後にある公式、payment = principal × r ÷ (1 − (1 + r)^(−n))は、将来の各支払いを現在に割り引いて等額を解くもので、銀行・家主・年金基金のすべてが使うものと同じです。利率は期間ごとに表されるため、月利と月数、年利と年数など、一貫した組み合わせであればどの周期でも計算できます。

重要なのは一貫性で、利率と期間数は同じ間隔を表す必要があります。月利を送りながら期間数を年で数えると、答えは構造的に誤りとなり、どんな計算機でも単位の不一致は救えません。両者を揃えれば、結果は正確かつ決定的で、どのマシンでも再現可能です。

だからこそ、同じ計算がブラウザでもエッジでも同一に動作します。

入力・単位・エッジケース

元金は年金の現在価値、つまりローン金額、取り崩し中の資金、分割払いの対象価格であり、正の値である必要があります。期間ごとの利率は小数で表し、月利1%は0.01であって、1でも0.01%でもありません。期間数は支払い回数で、1200までの正の整数である必要があります。

これは100年分の月次支払いを十分にカバーします。二つのエッジケースは意図的に処理されています。利率ゼロは有効で、単純な割り算を意味します。

利息がなければ、支払額は元金を期間数で等分したものであり、これは利率がゼロに近づくときの公式の正しい数学的極限です。そのため、ゼロ除算で失敗させずに直接その値を返します。また、返される支払額は小数点以下2桁（セント）に丸められるため、応答は実行間・マシン間でバイト単位まで安定します。

この安定性は見た目のためではありません。お客様のシステムで結果をキャッシュしたり照合したりする場合も同様に比較できます。より高い精度が必要な場合は、お客様側で完全な精度を保持し、返された値を確定金額としてお使いください。

効果的な使い方と対象外の範囲

典型的な用途は三通りです。貸し手やマーケットプレイスは、本格的な審査フローの前に分割払いを提示するために呼び出します。支払額は顧客が最初に尋ねる数字だからです。

SaaS製品は独自の価格計算機能の背後に組み込み、計算ロジックを一か所で保守します。各フロントエンドで誤って再実装されることを避けるためです。財務チームは受け取った見積もりの逆算確認に使います。

販売店の月額が公式と一致しなければ、手数料や保険料などが支払いに隠れていることになります。返すのは支払額のみで、利息と元金の内訳を含む期間ごとの償還表は生成しません。それは別の機能です。 また、各期末に支払いが行われる普通年金を前提としています。

期首払いの先払年金とは(1 + r)の係数分だけ異なります。さらに、手数料、税金、バルーン返済、金利変動はモデル化していません。お客様のケースが単純な年金モデルに合うなら、これが適切なツールです。

合わない場合は、ここで支払額を基準値として計算し、追加分はお客様のコードで重ねてください。