Compartilhar via


CUMIPMT

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna os juros cumulativos pagos em um empréstimo entre start_period e end_period.

Sintaxe

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

Parâmetros

Prazo 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 (inclusivo).
end_period O último período no cálculo. Deve estar entre start_period e nper (inclusivo).
type O tempo do pagamento. Os valores aceitos estão listados abaixo desta tabela.

O parâmetro type aceita os seguintes valores:

Type de Tempo
0 (zero) Pagamento no final do período
1 Pagamento no início do período

Valor retornado

Os juros cumulativos pagos no período especificado.

Observações

  • Verifique se você é consistente com as unidades usadas para especificar taxa e nper. Se você fizer pagamentos mensais em um empréstimo de quatro anos a uma taxa de juros anual de 10%, use 0,1/12 para taxa e 4*12 para nper. Se você fizer pagamentos anuais no mesmo empréstimo, use 0,1 para taxa e 4 para nper.

  • start_period, end_period e tipo são arredondados para o inteiro mais próximo.

  • Um erro será retornado se:

    • taxa ≤ 0.
    • nper < 1.
    • pv ≤ 0.
    • start_period < 1 ou start_period > end_period.
    • end_period < start_period ou end_period > nper.
    • o tipo é qualquer número diferente de 0 ou 1.
  • Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).

Exemplos

data descrição
9% Taxa de juros anual
30 Anos do empréstimo
125000 Valor presente

Exemplo 1

A seguinte consulta DAX:

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

Retorna os juros totais pagos no segundo ano de pagamentos, períodos de 13 a 24 anos, supondo que os pagamentos sejam feitos no início de cada mês.

[Valor]
-11052.3395838718

Exemplo 2

A seguinte consulta DAX:

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

Retorna os juros pagos em um único pagamento no primeiro mês, supondo que o pagamento seja feito no final do mês.

[Valor]
-937.5