# Documentation/Calc Functions/TBILLYIELD

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.

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

TBILLYIELD