COUPNUM

  • Artigo

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

Termo Definição
settlement A data de liquidação do título. A data de liquidação do título será a data posterior à data de emissão quando o título for negociado com o comprador.
maturity A data de vencimento do título. A data de vencimento é a data de expiração do título.
frequência O número de pagamentos de cupons por ano. Para pagamentos anuais: frequency = 1, para pagamentos semestrais: frequency = 2 e para pagamentos trimestrais: frequency = 4.
basis (Opcional) O tipo de base de contagem de dias a ser usado. Caso basis seja omitido, ele será considerado 0. Os valores aceitos estão listados na tabela abaixo.

O parâmetro basis aceita os seguintes valores:

Base Base de contagem diária
0 ou omitido US (NASD) 30/360
1 Real/real
2 Real/360
3 Real/365
4 Europeu 30/360

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

Dados Descrição
25-jan-07 Data de liquidação
15-nov-08 Data de vencimento
2 Cupom semestral (confira acima)
1 Real/base real (confira acima)

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.

[Value]
4