COUPDAYS
aplica-se a:coluna calculada
tabela calculada
medida
cá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 |