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