CUMPRINC

  • Artigo

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna o valor principal cumulativo pago em um empréstimo entre start_period e end_period.

Sintaxe

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

Parâmetros

Termo Definição
rate A taxa de juros.
nper O número total de períodos de pagamento.
pv O valor atual.
start_period O primeiro período no cálculo. Deve estar entre 1 e end_period (inclusive).
end_period O último período no cálculo. Precisa estar entre start_period e nper (inclusive).
tipo O momento do pagamento. Os valores aceitos estão listados na tabela abaixo.

O parâmetro type aceitará os seguintes valores:

Tipo Timing
0 (zero) Pagamento no final do período
1 Pagamento no início do período

Valor Retornado

O valor principal acumulado pago no período especificado.

Comentários

  • Seja consistente em relação às unidades que você usa para especificar rate e nper. Caso faça pagamentos mensais em um empréstimo de quatro anos a uma taxa de juros anual de 10%, use 0,1/12 para rate e 4*12 para nper. Caso faça pagamentos anuais no mesmo empréstimo, use 0,1 para rate e 4 para nper.

  • start_period, end_period e type são arredondados para o número inteiro mais próximo.

  • Um erro será retornado se:

    • rate ≤ 0.
    • nper < 1.
    • pv ≤0.
    • start_period < 1 ou start_period > end_period.
    • end_period < start_period ou end_period > nper.
    • type é qualquer número diferente de 0 ou 1.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplos

Dados Descrição
9% Taxa de juros anual
30 Prazo em anos
125000 Valor atual

Exemplo 1

A seguinte consulta DAX:

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

Retorna o valor principal total pago no segundo ano de pagamentos, períodos de 13 a 24, supondo que os pagamentos sejam feitos no início de cada mês.

[Value]
-927,153472378062

Exemplo 2

A seguinte consulta DAX:

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

Retorna o valor principal pago em um pagamento no primeiro mês, supondo que o pagamento seja feito no final do mês.

[Value]
-68,2782711809784