COUPNUM

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna o número de cupons a pagar entre a data de liquidação e a data de vencimento, arredondado para o cupom inteiro mais próximo.

Sintaxe

COUPNUM(<settlement>, <maturity>, <frequency>[, <basis>])

Parâmetros

O parâmetro basis aceita os seguintes valores:

Valor Retornado

O número de cupons a pagar entre a data de liquidação e a data de vencimento.

Comentários

• As datas são armazenadas como números de série sequenciais para que possam ser usadas nos cálculos. No DAX, 30 de dezembro de 1899 será o dia 0 e 1º de janeiro de 2008 será o dia 39448 porque são 39.448 dias após 30 de dezembro de 1899.

• A data de liquidação será a data em que o comprador adquire um cupom, como um título de dívida. A data de vencimento será a data de expiração de um cupom. Por exemplo, suponha que um título de dívida de 30 anos seja emitido em 1º de janeiro de 2008 e adquirido por um comprador seis meses depois. A data de emissão seria 1º de janeiro de 2008, a data de liquidação seria 1º de julho de 2008 e a data de vencimento seria 1º de janeiro de 2038, ou seja, 30 anos após a data de emissão em 1º de janeiro de 2008.

• settlement e maturity serão arredondados para números inteiros.

• frequency e basis são arredondados para obter o número inteiro mais próximo.

• Um erro será retornado se:

  • settlement ou maturity não forem datas válidas.
  • settlement ≥ maturity.
  • frequency for qualquer número diferente de 1, 2 ou 4.
  • basis < 0 ou basis > 4.

• 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.

Exemplo

A seguinte consulta DAX:

EVALUATE
{
  COUPNUM(DATE(2007,1,25), DATE(2008,11,15), 2, 1)
}

Retorna o número de pagamentos de cupom para um título de dívida com os termos especificados acima.