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