Ler em inglês

Compartilhar via


ODDFYIELD

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna o rendimento de um título que tem um período inicial (curto ou longo) indefinido.

Sintaxe

DAX
ODDFYIELD(<settlement>, <maturity>, <issue>, <first_coupon>, <rate>, <pr>, <redemption>, <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.
problema A data de emissão do título.
first_coupon A data inicial do cupom do título.
rate A taxa de juros do título.
pr O preço do título.
redemption O valor de resgate do título por US$ 100 de valor nominal.
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 rendimento do título.

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.

  • A função ODDFYIELD será calculada usando um método iterativo. Ela usará o método de Newton com base na fórmula usada para a função ODDFPRICE. O rendimento será alterado por meio de iterações de 100 até que o preço estimado de um determinado rendimento esteja próximo do preço. Confira ODDFPRICE para obter a fórmula que ODDFYIELD usa.

  • settlement, maturity, issue e first_coupon serão arredondados para obter números inteiros.

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

  • Um erro será retornado se:

    • settlement, maturity, issue ou first_coupon não for válido.
    • maturity > first_coupon > settlement > issue não é aceitável.
    • rate < 0.
    • pr ≤ 0.
    • redemption ≤ 0.
    • 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 de argumento
11 de novembro de 2008 Data de liquidação
1º de março de 2021 Data de vencimento
15 de outubro de 2008 Data de emissão
1º de março de 2009 Data inicial do cupom
5,75% Cupom percentual
84,50 Preço
100 Valor de quitação
2 A frequência é semestral
0 Base de 30/360

A seguinte consulta DAX:

DAX
EVALUATE
{
  ODDFYIELD(DATE(2008,11,11), DATE(2021,3,1), DATE(2008,10,15), DATE(2009,3,1), 0.0575, 84.50, 100, 2, 0)
}

Retorna o rendimento de um título que tem um período inicial (curto ou longo) indefinido usando os termos especificados acima.

[Value]
0,0772455415972989