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