Documentation/Calc Functions/TBILLPRICE

From The Document Foundation Wiki
Jump to: navigation, search

Function name:

TBILLPRICE

Category:

Financial Analysis

Summary:

Calculates the price of a treasury bill per 100 currency units.

Syntax:

TBILLPRICE(Settlement; Maturity; Discount)

Returns:

Returns a real number which is the price per 100 face value 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).

Discount is a positive real number or a reference to the cell containing that number which is the discount of security as a percentage or fraction.

  • 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 Discount is less than or equal to 0 then the function returns an error value.

Additional details:

None

Examples:

Formula Description Returns
=TBILLPRICE("1999-03-31";"1999-06-01"; 0.0914) Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9 per cent. The function calculates the price of the treasury bill using this information. 98.4258888888889
=TBILLPRICE("1999-02-15.05"; "1999-03-01"; 0.0525) The function returns an error value if either Settlement or Maturity are not valid dates. #VALUE!
=TBILLPRICE("2008-02-15"; "1999-03-01"; 0.0525) The function returns an error when Settlement date is after the Maturity date. Err:502

Related LibreOffice functions:

TBILLEQ

TBILLYIELD

ODF standard:

Section 6.12.48, part 2

Equivalent Excel functions:

TBILLPRICE