Treasury Shares (Historical) Formula in Excel
Understanding Treasury Shares (Historical)
Treasury shares indicate the portion of a company’s stock that has been repurchased from shareholders. Tracking these shares provides insights into how much of the company’s equity has been reacquired, which can affect share price, ownership, and other key financial metrics. With MarketXLS, you can quickly retrieve historical treasury share data in Excel for various years and quarters.
-
Purpose and Use Cases
- Evaluate how actively a company is buying back its own shares.
- Compare multiple companies’ share repurchase behaviors over time.
- Assess potential impacts on earnings per share and shareholder value.
-
Key Benefits
- Instant access to historical fundamentals with a simple formula.
- Quick evaluation of stock buyback trends and investor sentiment.
-
When to Use
- Analyzing financial statements to understand changes in share count.
- Performing valuation models that factor in share repurchases.
- Conducting historical stock performance analysis.
Syntax and Parameters
Use the hf_Treasury_Shares
function to retrieve historical treasury share data for a given symbol, year, quarter, and optional trailing twelve-month (TTM) period.
=hf_Treasury_Shares(Symbol, Year, [Quarter], [TTM])
Parameter | Description | Required | Example |
---|---|---|---|
Symbol | The ticker symbol of the security (e.g., "MSFT", "^SPX", "@MSFT 110122C00020000", "BTCUSD:DEFAULT"). | Yes | "MSFT" |
Year | The reporting year or relative period indicator (e.g., "2022", "lq", "ly", "lt"). | Yes | "2022" or "ly-1" |
Quarter | The calendar quarter for which the data is required ("1" for Q1, "2" for Q2, etc.). Defaults to "1". | No | 2 |
TTM | Specify "TTM" to retrieve trailing twelve-month data; otherwise leave blank. | No | "TTM" |
?? Note: This formula returns
NA
if the symbol is invalid, the license is not valid, or if there is an error retrieving the data.
Return Value
- Typically returns a numeric value representing the count of treasury shares for the selected period.
- Returns the string "NA" if an error occurs or data is unavailable.
Special Cases and Limitations
- Only valid for symbols recognized by MarketXLS.
- A valid MarketXLS subscription is required.
- Large batch requests could be slower due to external API calls.
Date Input Formats
Although this function primarily accepts a year (e.g., 2022), you can supply date-based inputs in various ways if needed (for relative or custom period calculations). Some formats include:
- Cell reference:
=hf_Treasury_Shares(A1)
- Direct date:
=hf_Treasury_Shares("2024-03-15")
- Using Excel date functions:
=hf_Treasury_Shares(TEXT(A1,"yyyy-mm-dd"))
? Pro Tip: Use relative period indicators like "lq" (last quarter), "ly-1" (one year before last year), or "lt" (last twelve months) to automate rolling calculations.
Examples and Usage
Below are practical examples demonstrating how to use the hf_Treasury_Shares
formula in various scenarios. Replace "MSFT" with your desired symbol as needed.
-
Retrieve treasury shares data for a specific year:
=hf_Treasury_Shares("MSFT", 2022)
This returns the treasury shares in 2022.
-
Retrieve treasury shares data for a specific quarter of a year:
=hf_Treasury_Shares("MSFT", 2022, 2)
This returns the treasury shares in Q2 of 2022.
-
Retrieve trailing twelve-month value:
=hf_Treasury_Shares("MSFT", 2022, 3, "TTM")
Shows the trailing twelve-month figure from Q3 2022.
-
Retrieve last quarter or last year:
=hf_Treasury_Shares("MSFT", "lq") =hf_Treasury_Shares("MSFT", "ly")
Dynamically references data for the last reported quarter or last reported year.
-
Using offsets from the last quarter/year:
=hf_Treasury_Shares("MSFT", "lq-1") =hf_Treasury_Shares("MSFT", "ly-1")
Retrieves treasury shares for one quarter or one year before the last reported period.
Common Questions
1. What if the formula returns “NA”?
- This might happen if the symbol is invalid or MarketXLS could not retrieve data. Double-check symbol correctness and ensure you have an active MarketXLS license.
2. Can I use this to compare multiple companies at once?
- Yes. Apply
hf_Treasury_Shares
across different cells/symbols to compare data side by side.
3. Does the function update automatically?
- By default, MarketXLS functions refresh with your sheet’s recalculations. You can also manually refresh data by pressing F9 or using MarketXLS’s refresh options.
4. Are there performance considerations with large data sets?
- Yes. Each function call queries MarketXLS’s data servers. For large analysis, consider using fewer calls or caching results to improve performance.
5. What if I need more historical periods?
- Simply adjust the parameters (e.g., year, quarter, TTM) or use additional cells referencing different periods as needed.
?? Note: Refer to other functions like
hf_Revenue
,hf_CostOfRevenue
,hf_GrossProfit
,hf_RnD_Expense
, andhf_SellingGeneralandAdministrative
for broader fundamental analysis.