Finance クラスは BIRT で提供される JavaScript クラスであり、さまざまな一般的ビジネス計算の実行に使用できる静的な財務関数のセットを提供します。財務上の値は、浮動小数点の値として表されます。
アプリケーションではこのクラスのインスタンスを作成できません。
この関数は、倍額定率法を使用して、所与の単一の期間における資産の減価償却を戻します。倍額定率法は加速する減価償却の方法であり、課金が期間中一定である定額償却法 (SLN) よりも固定資産の耐用年数の初期の年度における減価償却の課金が高く、税金を節約できます。
この関数は、単一の期間に対する減価償却に以下の式を使用します。
以下の規則が適用されます。
構文
パラメーター
initial
Double 型。その資産の初期コストを指定する数値表現。
salvage
Double 型。耐用年数の終了時におけるその資産の価値を指定する数値表現。
life
Double 型。その資産の耐用年数の長さを指定する数値表現。 この値は、singlePeriod と同じ計測単位で指定する必要があります。
例えば、singlePeriod が 1 カ月を表している場合、assetLifespan は月数で表現する必要があります。
period
Integer 型。DDB で減価償却を計算する期間を指定する数値表現。 この値は、assetLifespan と同じ計測単位で指定する必要があります。
例えば、assetLifespan が月数で表現される場合、singlePeriod は 1 カ月の期間を表している必要があります。
戻り値
Double 型。
例
以下の例では、$1400 で購入された新規の機械の初年度の減価償却を、$200 の残存価額、および予定耐用年数 10 年で 2 倍定率法を使用して計算しています。結果 ($280) は、以下の変数 Year1Deprec に代入されます。
関連事項
Finance.sln 関数
Finance.syd 関数
この関数は、定期的な定額支払いおよび不変の利率に基づいた、将来の年賦金の金額を戻します。年賦金とは、一定の期間にわたり定額で支払われる、一連の金銭支払です。
年賦金には、毎月の貯蓄プランなどの投資や、住宅抵当などのローンなどがあります。
年賦金の将来価値は、最後の支払終了後の金銭残高です。
例えば、子供の教育資金として 18 年後に目標の $75,000 が支払われる貯蓄プランをセットアップする場合、そのプランの将来価値は $75,000 です。
または、$11,000 のローンを組む場合、それが典型的なローンであれば、そのローンの将来価値は $0.00 です。
以下の規則が適用されます。
構文
パラメーター
rate
期間ごとに生じる利率を指定する double 型の数値表現。この値は、numberPayPeriods と同じ計測単位で指定する必要があります。
例えば、numberPayPeriods が月数で表現される場合、ratePerPeriod は月間の率で表現する必要があります。
nPer
その年賦金の支払期間の総数を指定する整数。この値は、ratePerPeriod と同じ計測単位で指定する必要があります。
例えば、ratePerPeriod が月間の率で表現される場合、numberPayPeriods は月数で表現する必要があります。
pmt
各支払金額を指定する double 型の数値表現。この値は、ratePerPeriod と同じ計測単位で指定する必要があります。
例えば、ratePerPeriod が月数で表現される場合、eachPmt は毎月の支払で表現する必要があります。
pvalue
将来の支払い、または連続した支払いの本日の価値を指定する double 型の数値表現。例えば、本日、銀行に $23.94 預金し、年率 10% の複利で 15 年間据え置いた場合、最後には約 $100 になります。
その $100 の現在価値は、約 $23.94 です。
due
その支払いが各期間の初め (1) または終わり (0) に実行されるかを指定する整数。この値は 0 または 1 にする必要があります。
戻り値
Double 型
例
以下の例では、娘が誕生したので、その娘のために貯蓄口座に $10,000 預金したと仮定します。その口座に日率 5.7% の複利で支払われた場合、18 歳の大学生のときにはいくらになっているでしょうか。
答えは $27,896.60 であり、以下の変数 TotalValue に代入されます。
以下の例は、上記の例とほとんど同じです。ただし、この例では、日率ではなく月間の複利であると仮定し、追加で月間 $55 を口座に預金することを決定しています。
この場合、以下のように TotalValue に代入される将来価値は $48,575.82 です。
関連事項
Finance.impt 関数
Finance.nper 関数
Finance.pmt 関数
Finance.ppmt 関数
Finance.pv 関数
Finance.rate 関数
定期的な定額支払いおよび不変の利率に基づいた、指定された期間の年賦金の利息支払額を戻します。年賦金とは、一定の期間にわたり定額で支払われる、一連の金銭支払です。
年賦金には、毎月の貯蓄プランなどの投資や、住宅抵当などのローンなどがあります。
それぞれの支払いは、元金と利子の 2 つの部分で構成されています。
iPmt は、その支払いの利子部分を戻します。
以下の規則が適用されます。
構文
パラメーター
rate
期間ごとに生じる利率を指定する double 型の数値表現。この値は、numberPayPeriods と同じ計測単位で指定する必要があります。
例えば、numberPayPeriods が月数で表現される場合、ratePerPeriod は月間の率で表現する必要があります。
per
その期間に対する利子の支払い金額を決定する特定の期間を指定する整数。この値は、1 から numberPayPeriods までの範囲で指定する必要があります。
nPer
その年賦金の支払期間の総数を指定する整数。この値は ratePerPeriod と同じ計測単位で指定する必要があります。
例えば、ratePerPeriod が月間の率で表現される場合、numberPayPeriods は月数で表現する必要があります。
pvalue
将来の支払い、または連続した支払いの本日の価値を指定する double 型の数値表現。例えば、本日、銀行に $23.94 預金し、年率 10% の複利で 15 年間据え置いた場合、最後には約 $100 になります。
この場合、その $100 の現在価値は、約 $23.94 です。
fvalue
最後の支払終了後の金銭残高を指定する double 型の数値表現。例:
due
その支払いが各期間の初め (1) または終わり (0) に実行されるかを指定する整数。この値は 0 または 1 にする必要があります。
戻り値
Double 型。
例
以下の例では、年率 11.5% で 36 カ月の $20,000 のローンにおいて、各月の初日に毎月の支払いを行うと仮定します。5 回目の支払いにおける利子はいくらでしょうか。
答えは $171.83 であり、以下の Interest5 に代入されます。
関連事項
Finance.fv 関数
Finance.nper 関数
Finance.pmt 関数
Finance.ppmt 関数
Finance.pv 関数
Finance.rate 関数
この関数は、一連の定期的キャッシュ・フロー、支払い、および受け取りに関する内部戻り率を既存の配列内に戻します。内部戻り率は、定期的間隔で発生する支払いおよび受け取りで構成される投資に対する利率です。
各期間のキャッシュ・フローは、年賦金とは異なり、定数にする必要はありません。
IRR は、正味現在価値の関数 (NPV) と緊密に関係していて、IRR により計算される戻り率は、ゼロの正味現在価値に該当する利率です。IRR は、反復して計算されます。
<開始推定値>の値で開始し、結果が 0.00001 パーセント以内の精度になるまで計算が反復されます。
20 回反復しても結果を決定できない場合、関数は失敗します。
以下の規則が適用されます。
以下のヒントが役に立ちます。
構文
パラメーター
cash
キャッシュ・フローの値を表す double 型の既存の配列名を指定する double 型の値の配列。cashArray には、少なくとも 1 つの正の値、すなわち受け取り額、および 1 つの負の値、すなわち支払額が収容されている必要があります。
s
内部収益率の予想値を指定する double 型の数値表現。ほとんどの場合、この値は 0.1 または 10 パーセントです。
戻り値
Double 型
例
以下の例では、一連のキャッシュ・フローの値が配列 myArray に代入されていると仮定します。内部戻り率は、以下の変数 IRRValue に代入されます。
関連事項
Finance.mirr 関数
Finance.npv 関数
Finance.rate 関数
この関数は、一連の定期的キャッシュ・フロー、または支払いおよび受け取りに関する変更済み内部戻り率を既存の配列内に戻します。変更済み内部戻り率は、支払いおよび受け取りが異なる率で融資された場合の内部戻り率 (IRR) です。
MIRR では、投資のコスト、すなわち financeRate、および金銭の再投資で受け取る利率、すなわち reinvestmentRate の両方が考慮されます。
以下の規則が適用されます。
MIRR は配列内の値の順序を使用して支払いおよび受け取りの順序を解釈するため、支払いおよび受け取りの金額は必ず正しい順序で入力してください。
構文
パラメーター
arptr
キャッシュ・フローの値の既存の配列名を指定する倍精度の配列。配列には、少なくとも 1 つの正の値、すなわち受け取り額、および 1 つの負の値、すなわち支払額が収容されている必要があります。
frate
融資のコストとして支払われる利率を指定する double 型の数値表現。パーセントを表す 10 進数にする必要があります。
rrate
金銭の再投資からの利益として受け取る利率を指定する double 型の数値表現。パーセントを表す 10 進数にする必要があります。
戻り値
Double 型。
例
以下の例では、一連のキャッシュ・フローの値が配列 myArray に代入されていると仮定します。融資で支払う利率が 12% であり、収入で獲得する率が 11.5% である場合、変更済み内部戻り率は何になるでしょうか。
答えは、以下の変数 MIRRValue に代入されます。
関連事項
Finance.irr 関数
Finance.rate 関数
定期的な定額支払いおよび不変の利率に基づいた、年賦金の期間数を戻します。年賦金とは、一定の期間にわたり定額で支払われる、一連の金銭支払です。
年賦金には、毎月の貯蓄プランなどの投資や、住宅抵当などのローンなどがあります。
以下の規則が適用されます。
構文
パラメーター
rate
期間ごとに生じる利率を指定する double 型の数値表現。この値は、eachPmt と同じ計測単位で指定する必要があります。
例えば、eachPmt 毎月の支払で表現される場合、ratePerPeriod は月間の率で表現する必要があります。
pmt
各支払金額を指定する double 型の数値表現。この値は、ratePerPeriod と同じ計測単位で指定する必要があります。
例えば、ratePerPeriod が月数で表現される場合、eachPmt は毎月の支払で表現する必要があります。
pvalue
将来の支払い、または連続した支払いの本日の価値を指定する double 型の数値表現。例えば、本日、銀行に $23.94 預金し、年率 10% の複利で 15 年間据え置いた場合、最後には約 $100 になります。
この場合、その $100 の現在価値は、約 $23.94 です。
fvalue
最後の支払終了後の金銭残高を指定する double 型の数値表現。例:
due
その支払いが各期間の初め (1) または終わり (0) に実行されるかを指定する整数。この値は 0 または 1 にする必要があります。
戻り値
Double 型。
例
以下の例では、年率 11.5% の $20,000 のローンについて、各月の初日に毎月の支払いを行うと仮定します。各支払が $653.26 である場合は、このローンの支払が完了するまで何回支払う必要があるでしょうか。
答えは 36 であり、以下の変数 NumPeriods に代入されます。
関連事項
Finance.fv 関数
Finance.impt 関数
Finance.pmt 関数
Finance.ppmt 関数
Finance.pv 関数
Finance.rate 関数
この関数は、所与の利率における正および負の両方の変動する一連の周期的キャッシュ・フローの正味現在価値を戻します。PV が一連の定額支払の現在価値を決定する一方で、NPV は一連の変動する支払に対して同様のことを実行します。
正味現在価値とは、ある投資に関連するすべての将来のキャッシュ・フローからすべての初期コストを引いた、本日の金額です。言い換えると、ある一時払い金額が銀行に本日預金され、対象のキャッシュ・フロー・ストリームでの意図と同じ期間据え置いて、所与の「利率」で利子が生じた場合の、その一連のキャッシュ・フローと同じ利益または損失を戻す、その金銭の一時払い金額です。
以下の規則が適用されます。
NPV は配列内の値の順序を使用して支払いおよび受け取りの順序を解釈するため、支払いおよび受け取りの金額は必ず正しい順序で入力してください。
構文
パラメーター
rate
その期間を通じた割引率を指定する double 型の数値表現。この値は、10 進数で表現する必要があります。
arptr
キャッシュ・フローの値の既存の配列名を指定する倍精度の配列。配列には、少なくとも 1 つの正の値、受け取り額、および 1 つの負の値、支払額が収容されている必要があります。
戻り値
Double 型。
例
以下の例では、一連のキャッシュ・フローの値が配列 myArray に代入されていて、利率が 11% であると仮定します。正味現在価値はいくらになるでしょうか。
答えは、以下の変数 NetPValue に代入されます。
この関数は、2 つの数値のパーセントを計算します。この関数では、パーセントの計算に関連する 2 つの主要ハウスキーピング・タスク、分子におけるゼロの処理、および NULL 値の処理を取り扱います。
構文
パラメーター
denom
Double 型。分母。
この引数には、数値を入れる必要があります。
num
Double 型。分子。
この引数には、数値を入れる必要があります。
この値にはゼロを使用できます。
valueIfZero
Double 型。分子がゼロの場合に戻されるパーセント値。
デフォルトは NULL です。
戻り値
パーセントで表現される 2 つの数値の比率。分子がゼロの場合は 0 を戻します。
2 つの引数のいずれかが NULL の場合は NULL を戻します。
例
定期的な定額支払いおよび不変の利率に基づいた、年賦金の支払いを戻します。年賦金とは、一定の期間にわたり定額で支払われる、一連の金銭支払です。
年賦金には、毎月の貯蓄プランなどの投資や、住宅抵当などのローンなどがあります。
以下の規則が適用されます。
構文
パラメーター
rate
期間ごとに生じる利率を指定する double 型の数値表現。この値は、ratePerPeriod と同じ計測単位で指定する必要があります。
例えば、numberPayPeriods が月数で表現される場合、ratePerPeriod は月間の率で表現する必要があります。
nPer
その年賦金の支払期間の総数を指定する整数。この値は、ratePerPeriod と同じ計測単位で指定する必要があります。
例えば、ratePerPeriod が月間の率で表現される場合、numberPayPeriods は月数で表現する必要があります。
pvalue
将来の支払い、または連続した支払いの本日の金額の価値を指定する double 型の数値表現。例えば、本日、銀行に $23.94 預金し、年率 10% の複利で 15 年間据え置いた場合、最後には約 $100 になります。
この場合、その $100 の現在価値は、約 $23.94 です。
fvalue
最後の支払終了後の金銭残高を指定する double 型の数値表現。例:
due
その支払いが各期間の初め (1) または終わり (0) に実行されるかを指定する整数。この値は 0 または 1 にする必要があります。
戻り値
Double 型。
例
以下の例では、年率 11.5% で 36 カ月の $20,000 のローンにおいて、各月の初日に毎月の支払いを行うと仮定します。各回の支払いはいくらになるでしょうか。
答えは $653.26 であり、以下の PaymentAmt に代入されます。
関連事項
Finance.fv 関数
Finance.impt 関数
Finance.nper 関数
Finance.ppmt 関数
Finance.pv 関数
Finance.rate 関数
定期的な定額支払いおよび不変の利率に基づいた、指定された期間の年賦金の元金支払額を戻します。年賦金とは、一定の期間にわたり定額で支払われる、一連の金銭支払です。
年賦金には、毎月の貯蓄プランなどの投資や、住宅抵当などのローンなどがあります。
年賦金における各支払いは、2 つの要素、元金および利子で構成されています。
ppmt は、その支払いの元金部分を戻します。
以下の規則が適用されます。
構文
パラメーター
rate
期間ごとに生じる利率を指定する double 型の数値表現。この値は、nPer と同じ計測単位で指定する必要があります。例えば、nPer が月数で表現される場合、rate は月間の率で表現する必要があります。
per
その期間に対する利子の支払い金額を決定する特定の期間を指定する整数。この値は、1 から nPer の範囲にする必要があります。
nPer
その年賦金の支払期間の総数を指定する整数。この値は、rate と同じ計測単位で指定する必要があります。例えば、rate が月間の率で表現される場合、nPer は月数で表現する必要があります。
pvalue
将来の支払い、または連続した支払いの本日の価値を指定する double 型の数値表現。例えば、本日、銀行に $23.94 預金し、年率 10% の複利で 15 年間据え置いた場合、最後には約 $100 になります。
この場合、その $100 の現在価値は、約 $23.94 です。
fvalue
最後の支払終了後の金銭残高を指定する double 型の数値表現。例:
due
その支払いが各期間の初め (1) または終わり (0) に実行されるかを指定する整数。この値は 0 または 1 にする必要があります。
戻り値
Double 型。
例
以下の例では、年率 11.5% で 36 カ月の $20,000 のローンにおいて、各月の初日に毎月の支払いを行うと仮定します。5 回目の支払いにおける元金はいくらでしょうか。
答えは $481.43 であり、以下の Principal5 に代入されます。
関連事項
Finance.fv 関数
Finance.impt 関数
Finance.nper 関数
Finance.pmt 関数
Finance.pv 関数
Finance.rate 関数
この関数は、将来支払われる定期的な定額支払いおよび不変の利率に基づいた、現在の年賦金の金額を戻します。年賦金とは、一定の期間にわたり定額で支払われる、一連の金銭支払です。
年賦金には、毎月の貯蓄プランなどの投資や、住宅抵当などのローンなどがあります。
現在の価値は、年賦金として構成された将来の支払いの、または連続した支払いの本日の価値です。
例えば、本日、銀行に $23.94 預金し、年率 10% の複利で 15 年間据え置いた場合、最後には約 $100 になります。
このように、その $100 の現在価値は、約 $23.94 です。
以下の規則が適用されます。
構文
パラメーター
rate
期間ごとに生じる利率を指定する double 型の数値表現。この値は、nPer と同じ計測単位で指定する必要があります。例えば、nPer が月数で表現される場合、rate は月間の率で表現する必要があります。
nPer
その年賦金の支払期間の総数を指定する整数。この値は、rate と同じ計測単位で指定する必要があります。例えば、rate が月間の率で表現される場合、nPer は月数で表現する必要があります。
pmt
各支払金額を指定する double 型の数値表現。この値は、rate と同じ計測単位で指定する必要があります。例えば、rate が月数で表現される場合、pmt は毎月の支払で表現する必要があります。
fvalue
Double 型。最後の支払終了後の金銭残高を指定します。 例:
due
その支払いが、各期間の初めまたは終わりのどちらで実行されるかを指定する整数。この値は、期間の初めの場合は 1、期間の終わりの場合は 0 (ゼロ) にする必要があります。
戻り値
Double 型
例
以下の例では、額面価格が $1000 の社債の購入を検討していると仮定します。この社債では $100 の年次クーポンを支払い、15 年で満期になり、次のクーポンは 1 年の終わりに支払われます。
同等の債券の満期利回りは 12.5% です。
この社債の適正価格、つまりその現在価値はいくらでしょうか。
答えは $834.18 であり、以下の変数 PresentValue に代入されます。
以下の例では、宝くじに当選したと仮定しています。当選金額は $10,000,000 であり、本日から年度が開始される 20 年間の分割払いで、年間 $500,000 を受け取ります。
年間の複利の利率が 9.5% である場合、この宝くじの本日の価値はいくらになるでしょうか。 答えは $4,406,191.06 であり、以下の PresentValue に代入されます。
以下の例では、3 年間の間に $11,000 の貯蓄をすると仮定しています。年率が 10.5% で毎月 $325 貯蓄し、各月の初日に支払うとすると、目標を達成するために必要な口座の開始金額はいくらでしょうか。
答えは $2,048.06 であり、以下の StartValue に代入されます。
eachPmt は支払金額を表すため、負の数値で表現されていることに注意してください。
関連事項
Finance.fv 関数
Finance.impt 関数
Finance.nper 関数
Finance.pmt 関数
Finance.ppmt 関数
Finance.rate 関数
この関数は、年賦金の各期間の利率を戻します。年賦金とは、一定の期間にわたり定額で支払われる、一連の金銭支払です。
年賦金には、毎月の貯蓄プランなどの投資や、住宅抵当などのローンなどがあります。
Rate は、反復する年賦金の利率を計算します。startingGuess に値で開始し、結果が 0.00001 パーセント以内の精度になるまで計算が反復されます。
20 回反復しても結果を決定できない場合、関数は失敗します。
以下の規則が適用されます。
以下のヒントが役に立ちます。
構文
パラメーター
nper
その年賦金の支払期間の総数を指定する整数。この値は、pmt と同じ計測単位で指定する必要があります。例えば、pmt が毎月の支払いで表現される場合、nper は月数で表現する必要があります。
pmt
各支払金額を指定する double 型の数値表現。この値は、nper と同じ計測単位で指定する必要があります。例えば、nper が月数で表現される場合、pmt は毎月の支払で表現する必要があります。
pvalue
将来の支払い、または連続した支払いの本日の価値を指定する double 型の数値表現。例えば、本日、銀行に $23.94 預金し、年率 10% の複利で 15 年間据え置いた場合、最後には約 $100 になります。
したがってこの場合、その $100 の現在価値は、約 $23.94 です。
fvalue
最後の支払終了後の金銭残高を指定する double 型の数値表現。例:
due
その支払いが、各期間の初めまたは終わりのどちらで実行されるかを指定する整数。この値は、期間の初めの場合は 1、期間の終わりの場合は 0 (ゼロ) にする必要があります。
guess
戻される Rate の予想値を指定する double 型の数値表現。ほとんどの場合、この値は 0.1 または 10 パーセントです。
戻り値
Double 型
例
以下の例では、$20,000 のローンを組み、3 年間の間支払いを続けると仮定しています。毎月の支払いが $653.26 であり、各月の初日に支払うとすると、支払いの利率 (年率) はどれくらいになるでしょうか。
答えは .115 または 11.5% であり、以下の変数 InterestRate に代入されます。
Rate の戻り値は 12 倍にして年率にする必要があることに注意してください。
関連事項
Finance.fv 関数
Finance.impt 関数
Finance.nper 関数
Finance.pmt 関数
Finance.ppmt 関数
Finance.pv 関数
この関数は、単一期間の資産の定額償却を戻します。定額償却は、固定資産を減価償却する、最も古い単純な方法です。
その資産の評価残余価値より低い帳簿価額を使用し、その資産の耐用年数の各期間で均等に差額を割り振ります。この手順を使用すると、所得税を計算する前の所得に対して課金する年間の減価償却費用が均等になります。
すべての引数は、正数にする必要があります。
構文
パラメーター
cost
その資産の初期コストを指定する double 型の数値表現。
salvage
耐用年数の終了時におけるその資産の価値を指定する double 型の数値表現。残存価額を入力すると、その残存価額による定額償却の差し引き勘定を表示できます。
また、残存価額に 0 (ゼロ) を入力すると、残存価額なしの定額償却が戻されます。
life
その資産の耐用年数の長さを指定する double 型の数値表現。この値は、この関数の戻り値と同じ計測単位で指定する必要があります。
例えば、SLN でその資産の年間の減価償却を算出する場合、assetLifespan は年数で指定する必要があります。
戻り値
Double 型。
例
以下の例では、$1400 で購入された新規の機械の減価償却を、$200 の残存価額、および予定耐用年数 10 年で定額法を使用して計算しています。結果の年間 $120 は、以下の AnnualDeprec に代入されます。
関連事項
Finance.ddb 関数
Finance.syd 関数
この関数は、指定された期間の資産の算術級数法減価償却を戻します。算術級数法は最初に多額の償却を行う減価償却の方法であり、課金が期間中一定である定額償却法 (SLN) よりも、固定資産の耐用年数の初期の年度における減価償却の課金が高く、税金を節約できます。
この関数は、耐用年数の各年の数字の合計を反転したスケールの減価償却に基づいています。例えば、その資産の耐用年数が 4 年である場合は、4、3、2、1 の各数字が加算されて 10 になります。初年度の SYD は、その資産の償却可能金額の 10 分の 4、または残存価額より低い金額になります。
2 年目のレートは 10 分の 3 になり、それ以降も同様です。
以下の規則が適用されます。
構文
パラメーター
cost
その資産の初期コストを指定する double 型の数値表現。
salvage
耐用年数の終了時におけるその資産の価値を指定する double 型の数値表現。
life
その資産の耐用年数の長さを指定する double 型の数値表現。この値は、period と同じ計測単位で指定する必要があります。例えば、period が 1 カ月を表している場合、life は月数で表現する必要があります。
period
syd で減価償却を計算する期間を指定する整数。この値は、life と同じ計測単位で指定する必要があります。例えば、life が月数で表現される場合、period は 1 カ月の期間を表している必要があります。
戻り値
Double 型
例
以下の例では、$1400 で購入された新規の機械の初年度の減価償却を、$200 の残存価額、および予定耐用年数 10 年で算術級数法を使用して計算しています。結果の $218.18 は、以下の Year1Deprec に代入されます。
注記:
以下の例では、同じ資産に対する耐用年数の 2 年目の減価償却を計算しています。結果の $196.36 は、以下の Year2Deprec に代入されます。
注記:
関連事項
Finance.ddb 関数
Finance.sln 関数