WorksheetFunction.TBillYield(Object, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Retorna o rendimento de uma obrigação do Tesouro.

public double TBillYield (object Arg1, object Arg2, object Arg3);

Public Function TBillYield (Arg1 As Object, Arg2 As Object, Optional Arg3 As Object) As Double

Parâmetros

Arg1

Object

Liquidação - a data de liquidação da obrigação do Tesouro. A data de liquidação do título é a data após a data de emissão quando a obrigação do Tesouro é negociada com o comprador.

Arg2

Object

Vencimento - a data de vencimento da obrigação do Tesouro. A data de vencimento é a data em que a obrigação do Tesouro expira.

Arg3

Object

Pr - o preço da obrigação do Tesouro por R$ 100,00 de valor nominal.

Retornos

Double

Comentários

Importante: as datas devem ser inseridas usando a função DATE ou como resultados de outras fórmulas ou funções. Por exemplo, use DATA(2008;5;23) para 23 de maio de 2008. Poderão ocorrer problemas se as datas forem inseridas como texto.

O Microsoft Excel armazena datas como números de série sequenciais para que eles possam ser usados em cálculos. Por padrão, 1 de janeiro de 1900 é o número de série 1, e 1 de janeiro de 2008 é o número de série 39448, porque vem 39.448 dias depois de 1 de janeiro de 1900. O Microsoft Excel para o Macintosh usa um sistema de data diferente como padrão.

Liquidação e vencimento são truncados para números inteiros.

Se liquidação ou vencimento não for uma data válida, TBillYield retornará o #VALUE! valor de erro.

Se pr ≤ 0, TBillYield retornará o #NUM! valor de erro.

Se a liquidação ≥ vencimento ou se o vencimento for mais de um ano após a liquidação, TBillYield retornará o #NUM! valor de erro.

TBillYield é calculado da seguinte maneira:

Figura 1: Equação para o método TBillYield

em que:

DSM = número de dias da liquidação ao vencimento, excluindo qualquer data de vencimento que seja mais de um ano civil após a data de liquidação.