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