Pular para o conteúdo principal
A documentação abaixo é gerada com base na tabela de sistema system.functions

​
financialInternalRateOfReturn

Introduzido em: v25.7.0 Calcula a Taxa Interna de Retorno (IRR) para uma série de fluxos de caixa que ocorrem em intervalos regulares. A IRR é a taxa de desconto para a qual o Valor Presente Líquido (VPL) é igual a zero. A IRR busca resolver a seguinte equação: \sum_{i=0}^n \frac{cashflow_i}{(1 + irr)^i} = 0 Sintaxe 
financialInternalRateOfReturn(cashflows[, guess])
Argumentos
  • cashflows — Array de fluxos de caixa. Cada valor representa um pagamento (valor negativo) ou uma entrada (valor positivo). Array(Int8/16/32/64) ou Array(Float*)
  • [, guess] — Estimativa inicial opcional (valor constante) para a taxa interna de retorno (padrão: 0.1). Float*
Valor retornado Retorna a taxa interna de retorno ou NaN se o cálculo não convergir, se o array de entrada estiver vazio ou contiver apenas um elemento, se todos os fluxos de caixa forem zero ou se ocorrerem outros erros de cálculo. Float64 Exemplos simple_example
Query
SELECT financialInternalRateOfReturn([-100, 39, 59, 55, 20])
Response
0.2809484211599611
simple_example_with_guess
Query
SELECT financialInternalRateOfReturn([-100, 39, 59, 55, 20], 0.1)
Response
0.2809484211599611

​
financialInternalRateOfReturnExtended

Introduzido em: v25.7.0 Calcula a Taxa Interna de Retorno Estendida (XIRR) para uma série de fluxos de caixa que ocorrem em intervalos irregulares. O XIRR é a taxa de desconto na qual o valor presente líquido (VPL) de todos os fluxos de caixa é igual a zero. O XIRR tenta resolver a seguinte equação (exemplo para ACT_365F): ∑i=0ncashflowi(1+rate)(datei−date0)/365=0\sum_{i=0}^n \frac{cashflow_i}{(1 + rate)^{(date_i - date_0)/365}} = 0 Os arrays devem estar ordenados por data em ordem crescente. As datas devem ser únicas. Syntax 
financialInternalRateOfReturnExtended(cashflow, date [, guess, daycount])
Arguments
  • cashflow — Um array de fluxos de caixa correspondentes às datas no segundo parâmetro. Array(Int8/16/32/64) ou Array(Float*)
  • date — Um array ordenado de datas únicas correspondentes aos fluxos de caixa. Array(Date) ou Array(Date32)
  • [, guess] — Opcional. Estimativa inicial (valor constante) para o cálculo do XIRR. Float*
  • [, daycount] — Convenção de contagem de dias opcional (padrão: ‘ACT_365F’). Valores suportados:
  • ‘ACT_365F’ - Actual/365 Fixed: Usa o número real de dias entre as datas dividido por 365
  • ‘ACT_365_25’ - Actual/365.25: Usa o número real de dias entre as datas dividido por 365,25 String
Returned value Retorna o valor do XIRR. Se o cálculo não puder ser realizado, retorna NaN. Float64 Examples simple_example
Query
SELECT financialInternalRateOfReturnExtended([-10000, 5750, 4250, 3250], [toDate('2020-01-01'), toDate('2020-03-01'), toDate('2020-10-30'), toDate('2021-02-15')])
Response
0.6342972615260243
simple_example_with_guess
Query
SELECT financialInternalRateOfReturnExtended([-10000, 5750, 4250, 3250], [toDate('2020-01-01'), toDate('2020-03-01'), toDate('2020-10-30'), toDate('2021-02-15')], 0.5)
Response
0.6342972615260243
simple_example_daycount
Query
SELECT round(financialInternalRateOfReturnExtended([100000, -110000], [toDate('2020-01-01'), toDate('2021-01-01')], 0.1, 'ACT_365_25'), 6) AS xirr_365_25
Response
0.099785

​
financialNetPresentValue

Introduzido em: v25.7.0 Calcula o Valor Presente Líquido (VPL) de uma série de fluxos de caixa, considerando intervalos de tempo iguais entre os fluxos de caixa. Variante padrão (start_from_zero = true): \sum_{i=0}^{N-1} \frac{values_i}{(1 + rate)^i} Variante compatível com o Excel (start_from_zero = false): \sum_{i=1}^{N} \frac{values_i}{(1 + rate)^i} Sintaxe 
financialNetPresentValue(rate, cashflows[, start_from_zero])
Argumentos
  • rate — A taxa de desconto a ser aplicada. Float*
  • cashflows — Array de fluxos de caixa. Cada valor representa um pagamento (valor negativo) ou uma entrada (valor positivo). Array(Int8/16/32/64) ou Array(Float*)
  • [, start_from_zero] — Parâmetro booleano opcional que indica se o cálculo do VPL deve começar no período 0 (true) ou no período 1 (false, compatível com o Excel). Padrão: true. Bool
Valor retornado Retorna o valor presente líquido como um valor do tipo Float64. Float64 Exemplos default_calculation
Query
SELECT financialNetPresentValue(0.08, [-40000., 5000., 8000., 12000., 30000.])
Response
3065.2226681795255
cálculo_compatível_com_excel
Query
SELECT financialNetPresentValue(0.08, [-40000., 5000., 8000., 12000., 30000.], false)
Response
2838.1691372032656

​
financialNetPresentValueExtended

Introduzido em: v25.7.0 Calcula o Valor Presente Líquido Estendido (XNPV) para uma série de fluxos de caixa que ocorrem em intervalos irregulares. O XNPV considera o momento exato de cada fluxo de caixa ao calcular o valor presente. Equação XNPV para ACT_365F: XNPV=∑i=1ncashflowi(1+rate)(datei−date0)/365XNPV=\sum_{i=1}^n \frac{cashflow_i}{(1 + rate)^{(date_i - date_0)/365}} Os arrays devem ser ordenados por data em ordem crescente. As datas devem ser únicas. Syntax 
financialNetPresentValueExtended(rate, cashflows, dates[, daycount])
Argumentos
  • rate — A taxa de desconto a ser aplicada. Float*
  • cashflows — Array de fluxos de caixa. Cada valor representa um pagamento (valor negativo) ou receita (valor positivo). Deve conter pelo menos um valor positivo e um negativo. Array(Int8/16/32/64) ou Array(Float*)
  • dates — Array de datas correspondentes a cada fluxo de caixa. Deve ter o mesmo tamanho que o array de cashflows. Array(Date) ou Array(Date32)
  • [, daycount] — Convenção de contagem de dias opcional. Valores suportados: 'ACT_365F' (padrão) — Actual/365 Fixed, 'ACT_365_25' — Actual/365.25. String
Valor retornado Retorna o valor presente líquido como um valor Float64. Float64 Exemplos Uso básico
Query
SELECT financialNetPresentValueExtended(0.1, [-10000., 5750., 4250., 3250.], [toDate('2020-01-01'), toDate('2020-03-01'), toDate('2020-10-30'), toDate('2021-02-15')])
Response
2506.579458169746
Usando uma convenção de contagem de dias diferente
Query
SELECT financialNetPresentValueExtended(0.1, [-10000., 5750., 4250., 3250.], [toDate('2020-01-01'), toDate('2020-03-01'), toDate('2020-10-30'), toDate('2021-02-15')], 'ACT_365_25')
Response
2507.067268742502
Última modificação em 10 de junho de 2026