RECEIVED

  • Artigo

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna o valor recebido no vencimento de um título totalmente investido.

Sintaxe

RECEIVED(<settlement>, <maturity>, <investment>, <discount>[, <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.
investment O valor investido no título.
discount A taxa de desconto do título.
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 valor recebido no 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.

  • RECEIVED será calculado da seguinte maneira:

    $$\text{RECEIVED} = \frac{\text{investment}}{1 - (\text{discount} \times \frac{\text{DIM}}{\text{B}})}$$

    em que:

    • $\text{B}$ = número de dias em um ano, dependendo da base anual.
    • $\text{DIM}$ = número de dias da emissão ao vencimento.

  • settlement e maturity serão arredondados para números inteiros.

  • basis é arredondado para o número inteiro mais próximo.

  • Um erro será retornado se:

    • settlement ou maturity não forem datas válidas.
    • settlement ≥ maturity.
    • investment ≤ 0.
    • discount ≤ 0.
    • 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

A seguinte consulta DAX:

Dados Descrição
15-fev-08 Data de liquidação (emissão)
15-maio-08 Data de vencimento
US$ 1.000.000,00 Investimento
5,75% Porcentagem da taxa de desconto
2 Base real/360 
EVALUATE
{
  RECEIVED(DATE(2008,2,15), DATE(2008,5,15), 1000000.00, 0.0575, 2)
}

Retorna o valor total a ser recebido no vencimento para um título de dívida com os termos especificados acima.

[Value]
1014584.6544071