prtbill

Price of Treasury bill

Syntax

Price = prtbill(Settle,Maturity,Face,Discount)

Description

Price = prtbill(Settle,Maturity,Face,Discount) returns the price for a Treasury bill.

Examples

Calculate the Price for a Treasury Bill

This example shows how to return the price for a Treasury bill, where the settlement date of a Treasury bill is February 10, 2002, the maturity date is August 6, 2002, the discount rate is 3.77%, and the par value is $1000.

Price = prtbill('2/10/2002', '8/6/2002', 1000, 0.0377)

Price = 
981.4642

Calculate the Price for a Treasury Bill Using datetime Inputs

This example shows how to use datetime inputs to return the price for a Treasury bill, where the settlement date of a Treasury bill is February 10, 2002, the maturity date is August 6, 2002, the discount rate is 3.77%, and the par value is $1000.

Price = prtbill(datetime(2002,2,10), datetime(2002,8,6), 1000, 0.0377)

Price = 
981.4642

Input Arguments

Settle — Settlement date for Treasury bill

datetime scalar | string scalar | date character vector

Settlement date for the Treasury bill, specified as a scalar datetime, string, or date character vector. The Settle date must be before the Maturity date.

To support existing code, prtbill also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

Maturity — Maturity date for Treasury bill

datetime scalar | string scalar | date character vector

Maturity date for the Treasury bill, specified as a scalar datetime, string, or date character vector.

To support existing code, prtbill also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

Face — Redemption value of Treasury bill

numeric

Redemption value (par value) of the Treasury bill, specified as a numeric value.

Data Types: double

Discount — Discount rate of Treasury bill

decimal fraction

Discount rate of the Treasury bill, specified as a decimal fraction value.

Data Types: double

Output Arguments

Price — Treasury bill price

numeric

Treasury bill price, returned as a numeric value.

References

[1] Bodie, Kane, and Marcus. Investments. McGraw-Hill Education, 2013.

Version History

Introduced before R2006a

R2022b: Serial date numbers not recommended

Although prtbill supports serial date numbers, datetime values are recommended instead. The datetime data type provides flexible date and time formats, storage out to nanosecond precision, and properties to account for time zones and daylight saving time.

To convert serial date numbers or text to datetime values, use the datetime function. For example:

t = datetime(738427.656845093,"ConvertFrom","datenum");
y = year(t)

y =

        2021

There are no plans to remove support for serial date number inputs.