Documentation/Calc Functions/TBILLYIELD

From The Document Foundation Wiki
Jump to navigation Jump to search


Function name:

TBILLYIELD

Category:

Financial Analysis

Summary:

Calculates the yield of a treasury bill.

Syntax:

TBILLYIELD(Settlement; Maturity; Price)

Returns:

Returns a real number (expressed as a percentage or fraction) which is the yield for a treasury bill.

Arguments:

Settlement is a date or a reference to a cell containing that date which is the date of purchase of the security.

Maturity is a date or a reference to a cell containing that date which is the date on which the security matures (expires).

Price is a positive real number or a reference to the cell containing that number which is the price (purchase price) of the treasury bill per 100 currency units of par value.

  • If either Maturity or Settlement is not valid dates then the function returns an value(#VALUE!) error.
  • If Settlement date is after the Maturity date then the function returns an error value.
  • If Price is less than or equal to 0 then the function returns an error value.

Additional details:

None

Examples:

Formula Description Returns
=TBILLYIELD("1999-03-31","1999-06-01", 98.45) Settlement date: March 31 1999, maturity date: June 1 1999, price: 98.45 currency units. The function calculates the yield of the treasury bill using this information. 0.091416962925342 or 9.14%
=TBILLYIELD("1999-02-15.05"; "1999-03-01"; 52.5) The function returns an error value if either Settlement or Maturity are not valid dates. #VALUE!
=TBILLYIELD("2008-02-15"; "1999-03-01"; 52.5) The function returns an error when Settlement date is after the Maturity date. Err:502

Related LibreOffice functions:

TBILLEQ

TBILLPRICE

ODF standard:

Section 6.12.49, part 2

Equivalent Excel functions:

TBILLYIELD