Ler em inglês

Partilhar via


COUPNUM

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Devolve o número de cupões a pagar entre a data de liquidação e a data de vencimento, arredondado para o cupão inteiro mais próximo.

Sintaxe

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

Parâmetros

Vigência Definição
settlement Data de liquidação do título. A data de liquidação do título é a data após a data de emissão em que o título é negociado para o comprador.
maturity A data de vencimento do título. A data de vencimento é a data em que o título expira.
frequency O número de pagamentos de cupões por ano. Para pagamentos anuais, frequência = 1; para semestral, frequência = 2; para trimestral, frequência = 4.
basis (Opcional) O tipo de base de contagem de dias a utilizar. Se a base for omitida, presume-se que seja 0. Os valores aceitos estão listados abaixo desta tabela.

O parâmetro basis aceita os seguintes valores:

Basis Base de contagem de dias
0 ou omitido EUA (NASD) 30/360
1 Real/real
2 Atual/360
3 Atual/365
4 Europeia 30/360

Valor de retorno

O número de cupões 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 é o dia 0, e 1 de janeiro de 2008 é 39448 porque é 39.448 dias após 30 de dezembro de 1899.

  • A data de liquidação é a data em que um comprador compra um cupão, como uma obrigação. A data de vencimento é a data em que um cupom expira. Por exemplo, suponha que um título de 30 anos é emitido em 1º de janeiro de 2008 e é comprado 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 de 1º de janeiro de 2008.

  • liquidação e vencimento são truncados para inteiros.

  • A frequência e a base são arredondadas para o número inteiro mais próximo.

  • Um erro será retornado se:

    • liquidação ou vencimento não é uma data válida.
    • liquidação ≥ vencimento.
    • frequência é qualquer número diferente de 1, 2 ou 4.
    • base < 0 ou base > 4.
  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo

de dados Descrição
25 De janeiro de 07 Data de liquidação
15 De novembro de 08 Data de vencimento
2 Cupão semestral (ver acima)
1 Base real/real (ver acima)

A seguinte consulta DAX:

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

Devolve o número de pagamentos de cupões de uma obrigação com os termos especificados acima.

[Valor]
4