Compartilhar via

COUPDAYS

  • Artigo

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna o número de dias no período de cupom que contém a data de liquidação.

Sintaxe

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

Parâmetros

Prazo Definição
settlement A data de liquidação da segurança. A data de liquidação de segurança é a data após a data de emissão em que o título é negociado com o comprador.
maturity A data de vencimento da segurança. A data de vencimento é a data em que o título expira.
frequency O número de pagamentos de cupom 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 diária a ser usada. Se a base for omitida, supõe-se que seja 0. Os valores aceitos estão listados abaixo desta tabela.

O parâmetro basis aceita os seguintes valores:

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

Valor retornado

O número de dias no período de cupom que contém a data de liquidação.

Observações

  • As datas são armazenadas como números de série sequenciais para que possam ser usadas em cálculos. Em 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 cupom, como um título. A data de vencimento é a data em que um cupom expira. Por exemplo, suponha que um título de 30 anos seja emitido em 1º de janeiro de 2008 e seja 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 é 1º de janeiro de 2038, 30 anos após a data de emissão de 1º de janeiro de 2008.

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

  • frequência e base são arredondadas para o 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.

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

Exemplo

data descrição
25-Jan-11 Data de liquidação
15-Nov-11 Data de vencimento
2 Cupom semestral (veja acima)
1 Base real/real (veja acima)

A seguinte consulta DAX:

EVALUATE
{
  COUPDAYS(DATE(2011,1,25), DATE(2011,11,15), 2, 1)
}

Retorna o número de dias no período de cupom que contém a data de liquidação, para um título com os termos especificados acima.

[Valor]
181