| Oracle® OLAP DMLリファレンス 11gリリース2 (11.2) B61346-03 |
|
 前 |
 次 |
FPMTSCHEDファンクションは、一連の固定金利分割払い融資を指定の期間数で完済するための返済スケジュール(元金と金利)を計算します。期間ごとに、その期間に受けた融資額および返済期間にわたって融資に適用される単一の金利を指定します。
FPMTSCHEDは、所定期間の支払い額を、その期間で受けた各融資または未払いの各融資に対する元金および金利支払い額の合計として計算します。
戻り値
DECIMAL
FPMTSCHEDファンクションによって返される結果は、loansとratesのすべてのディメンション、およびtime-dimension引数として使用されるディメンションの結合によってディメンション化されます。
パラメータ
初期融資額を含む数式。loansに時間ディメンションがない場合、またはloansが複数の時間ディメンションによってディメンション化されている場合、time-dimension引数が必要です。
loansに対する金利を含む数式。ratesがディメンション化された変数の場合、この変数は、異なる時間ディメンションなどの任意のディメンションによってディメンション化できます。ratesが時間ディメンションによってディメンション化される場合、その期間に受けた融資額に適用される各期間の金利を指定します。融資を受ける期間の金利は、その融資の返済期間を通じて適用されます。金利は小数値で表し、たとえば、5%は.05として表します。
一連の融資の全額返済に必要な支払い回数を指定する数式。n式はディメンション化できますが、時間ディメンション引数でディメンション化することはできません。loansがディメンション化される時間ディメンションの各期間に、またはtime-dimension引数で指定されるディメンションの各期間に、1回の支払いが行われます。たとえば、loansがmonthによってディメンション化される場合、毎月1回支払いが行われます。
金利支払い額が計算される基準になるディメンションの名前。loansの時間ディメンションがDAY、WEEK、MONTH、QUARTERまたはYEARの型である場合、loansに複数の時間ディメンションがないかぎり、time-dimension引数はオプションです。
FPMTSCHEDが支払いスケジュールを計算する際に、現行のステータス・リスト(つまり現在ステータスにあり、現行のステータスの順序に並んでいるディメンション値のみ)を使用することを指定します。デフォルトでは、デフォルトのステータス・リストが使用されます。
使用上の注意
FPMTSCHEDとNA値
loansの値がNA以外の値で、対応するratesの値がNAの場合、エラーが発生します。
FPMTSCHEDはNASKIPオプションの影響を受けます。NASKIPの設定がYES(デフォルト)であり、影響を受ける期間に対して融資額の値がNAである場合、FPMTSCHEDによって返される結果は、対応する金利の値がNAであるかNA以外であるかによって異なります。表7-11「特定期間の融資または金利の値がNAである場合のNASKIPの影響」は、特定の期間の融資または金利の値がNAである場合、NASKIPが結果にどのように影響するかを示しています。
たとえば、融資額の式と対応する金利の式の両方の値が1997年に対してNAであり、その後の年に対してNA以外であるとします。支払い回数が3である場合、FPMTSCHEDは1997、1998および1999年に対してNAを返します。2000年に対しては、FPMTSCHEDは1998、1999および2000年に受けた融資に対する支払い額を返します。
時間ディメンションのステータスの影響を受けないFPMTSCHED
FPMTSCHEDでは、時間ディメンションのステータスがどのように制限されているかにかかわらず、時間ディメンションの最初の値から計算を開始します。たとえば、loansはyearによってディメンション化されており、yearの値の範囲はYr95からYr99までの間であるとします。yearのステータスを制限してYr95を対象外にしている場合でも、計算は必ずYr95から開始されます。
ただし、loansが時間ディメンションによってディメンション化されていない場合は、FPMTSCHEDによって、時間ディメンションの現行のステータスの最初の値から計算が開始されます。たとえば、loansはyearによってディメンション化されていないが、yearがtime-dimensionとして指定されているとします。yearのステータスがYr97からYr99までに制限されると、計算はYr95からではなくYr97から開始されます。
例
例7-100 返済スケジュールの計算
次の文を実行すると、loansおよびratesという2つの変数が作成されます。
DEFINE loans DECIMAL <year> DEFINE rates DECIMAL <year>
変数loansおよびratesに、次の値を代入したとします。
year loans rates -------------- ---------- ---------- Yr95 100.00 0.05 Yr96 200.00 0.06 Yr97 300.00 0.07 Yr98 0.00 0.00 Yr99 0.00 0.00
各年のloansには、その年に受けた固定金利融資額の初期値が含まれます。各年のratesの値は、その年に受けた融資に対する金利で、それぞれの融資に対して、融資の返済が完了するまでその同一の金利が課されます。
次の文を実行すると、各融資の返済が3回払いと指定され、融資の元金と金利を全額返済する返済スケジュールが計算されます。
REPORT W 20 HEADING 'Payment' FPMTSCHED(loans, rates, 3, year)
生成されるレポートは次のとおりです。
YEAR Payment -------------- -------------------- Yr95 36.72 Yr96 111.54 Yr97 225.86 Yr98 189.14 Yr99 114.32
1995年の支払い額は、1995年に受けた$100の融資のうち支払い期限に到達した元金と、この融資に対する5パーセントの金利の合計額です。1996年の支払いは、1995年に受けた融資に対する2回目の支払い(元金および5%の金利)、および1996年に受けた$200の融資に対する1回目の支払い(元金および6%の金利)の合計です。1997年の支払いは、1995年に受けた融資に対する3回目の最後の支払い、1996年に受けた融資に対する3回払いのうちの2回目の支払い、および1997年に受けた$300の融資に対する1回目の支払い(元金および7%の金利)の合計です。1995年の融資は1997年に全額返済されるので、1998年の支払いは、1996年と1997年の融資の元金と金利が対象になります。1999年の支払いは、1997年の融資に対する元金および金利の最後の支払いです。
