CUMPRINCCUMPRINC

Gibt die kumulierte Kreditsumme für ein Darlehen zurück, die zwischen „start_period“ und „end_period“ zu zahlen ist.Returns the cumulative principal paid on a loan between start_period and end_period.

SyntaxSyntax

CUMPRINC(<rate>, <nper>, <pv>, <start_period>, <end_period>, <type>)

ParameterParameters

BenennungTerm DefinitionDefinition
raterate Der Zinssatz.The interest rate.
npernper Die Gesamtanzahl der Zahlungszeiträume.The total number of payment periods.
pvpv Der Gegenwartswert.The present value.
start_periodstart_period Der erste in die Berechnung einfließende Zeitraum.The first period in the calculation. Muss zwischen 1 und „end_period“ (einschließlich) liegen.Must be between 1 and end_period (inclusive).
end_periodend_period Der letzte in die Berechnung einfließende Zeitraum.The last period in the calculation. Muss zwischen „start_period“ und „nper“ (einschließlich) liegen.Must be between start_period and nper (inclusive).
Typtype Der Fälligkeitszeitpunkt der Zahlung.The timing of the payment. Die zulässigen Werte sind unterhalb dieser Tabelle aufgeführt.The accepted values are listed below this table.

Der Parameter type akzeptiert die folgenden Werte:The type parameter accepts the following values:

TypType Zeitliche SteuerungTiming
0 (Null)0 (zero) Die Zahlung ist am Ende des Zeitraums fällig.Payment at the end of the period
11 Die Zahlung ist am Anfang des Zeitraums fällig.Payment at the beginning of the period

RückgabewertReturn Value

Die kumulative Kreditsumme, die im angegebenen Zeitraum gezahlt wird.The cumulative principal paid in the specified period.

BemerkungenRemarks

  • Achten Sie darauf, für „rate“und „nper“ übereinstimmende Zeiteinheiten zu verwenden.Make sure that you are consistent about the units you use for specifying rate and nper. Wenn Sie für ein Darlehen mit vierjähriger Laufzeit und einer jährlichen Verzinsung von 10 % monatliche Zahlungen leisten, müssen Sie für „rate“ 0,1/12 und für „nper“ 4*12 angeben.If you make monthly payments on a four-year loan at an annual interest rate of 10 percent, use 0.1/12 for rate and 4*12 for nper. Wenn Sie für das gleiche Darlehen jährliche Zahlungen leisten, müssen Sie für „Zins“ 0,1 und für „Anzahl_Zahlungszeiträume“ 4 angeben.If you make annual payments on the same loan, use 0.1 for rate and 4 for nper.

  • „start_period“, „end_period“ und „type“ werden auf die nächste ganze Zahl gerundet.start_period, end_period, and type are rounded to the nearest integer.

  • Es wird ein Fehler zurückgegeben, wenn:An error is returned if:

    • rate ≤ 0.rate ≤ 0.
    • nper < 1.nper < 1.
    • pv ≤ 0.pv ≤ 0.
    • „start_period < 1“ oder „start_period > end_period“.start_period < 1 or start_period > end_period.
    • „end_period < start_period“ oder „end_period > nper“.end_period < start_period or end_period > nper.
    • „type“ ist eine beliebige Zahl ungleich 0 oder 1.type is any number other than 0 or 1.
  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

BeispieleExamples

DatenData BeschreibungDescription
9 %9% Jährlicher ZinssatzAnnual interest rate
3030 Laufzeit in JahrenTerm in years
125.000125000 GegenwartswertPresent value

Beispiel 1Example 1

Die folgende DAX-Abfrage:The following DAX query:

EVALUATE
{
  CUMPRINC(0.09/12, 30*12, 125000, 13, 24, 1)
}

Gibt die Gesamt-Kreditsumme zurück, die im zweiten Zahlungsjahr (Zeiträume 13 bis 24) gezahlt wurde, unter der Annahme, dass die Zahlungen zu Beginn jedes Monats erfolgen.Returns the total principal paid in the second year of payments, periods 13 through 24, assuming the payments are made at the beginning of each month.

[Wert][Value]
927,153472378062-927.153472378062

Beispiel 2Example 2

Die folgende DAX-Abfrage:The following DAX query:

EVALUATE
{
  CUMPRINC(0.09/12, 30*12, 125000, 1, 1, 0)
}

Gibt die in einer einzelnen Zahlung im ersten Monat gezahlte Kreditsumme unter der Annahme zurück, dass die Zahlung am Ende jedes Monats erfolgen.Returns the principal paid in a single payment in the first month, assuming the payment is made at the end of the month.

[Wert][Value]
-68,2782711809784-68.2782711809784