CUMPRINC

Artigo
01/22/2025

aplica-se a:coluna calculada tabela calculada medida cálculo visual

Retorna a entidade cumulativa paga em um empréstimo entre start_period e end_period.

Sintaxe

CUMPRINC(<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

A entidade de segurança cumulativa paga 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	Prazo em anos
125000	Valor presente

Exemplo 1

A seguinte consulta DAX:

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

Retorna o total de entidades pagas 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]
-927.153472378062

Exemplo 2

A seguinte consulta DAX:

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

Retorna a entidade de segurança paga em um único pagamento no primeiro mês, supondo que o pagamento seja feito no final do mês.

[Valor]
-68.2782711809784

Compartilhar via