RECEIVED
Aplica-se a:Coluna calculada
Tabela calculada
Medida
Cálculo visual
Devolve o montante recebido no vencimento de um título totalmente investido.
Sintaxe
RECEIVED(<settlement>, <maturity>, <investment>, <discount>[, <basis>])
Parâmetros
Termo | 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. |
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 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 montante recebido no vencimento.
Observações
As datas são armazenadas como números de série sequenciais para que possam ser usadas nos 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 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.
RECEIVED é calculado da seguinte forma:
$$\text{RECEIVED} = \frac{\text{investment}}{1 - (\text{discount} \times \frac{\text{DIM}}{\text{B}})}$$
onde:
- $\text{B}$ = número de dias em um ano, dependendo da base anual.
- $\text{DIM}$ = número de dias desde a emissão até ao vencimento.
liquidação e vencimento são truncados para inteiros.
base é arredondada 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.
- investimento ≤ 0.
- desconto ≤ 0.
- 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
O seguinte DAX consulta:
Dados | Descrição |
---|---|
15-Fev-08 | Data de liquidação (emissão) |
15-Maio-08 | Data de vencimento |
\$1.000.000,00 | Investimento |
5.75% | Taxa de desconto percentual |
2 | Base real/360 |
EVALUATE
{
RECEIVED(DATE(2008,2,15), DATE(2008,5,15), 1000000.00, 0.0575, 2)
}
Devolve o montante total a receber no vencimento, para uma obrigação com os termos acima especificados.
[Valor] |
---|
1014584.6544071 |