Total Common Shares Outstanding (Historical) Formula in Excel
Understanding Total Common Shares Outstanding (Historical)
The Total Common Shares Outstanding (Historical) formula helps you track how many shares a company has issued and are owned by shareholders for a specific period in the past. This allows Excel users to:
- Analyze historical share data for better investment decisions.
- Compare share counts across different fiscal periods to gauge dilution or stock repurchases.
- Integrate with other MarketXLS functions for comprehensive fundamental analysis.
Syntax and Parameters
Use the following syntax in Excel to call this function:
=hf_Total_Common_Shares_Outstanding(Symbol, year, [quarter], [TTM])
Parameter | Description | Required | Example |
---|---|---|---|
Symbol | The stock or asset symbol. Supports stocks (e.g. "MSFT"), indices (e.g. "^SPX"), options (e.g. "@MSFT 110122C00020000"), and crypto (e.g. "BTCUSD:DEFAULT"). | Yes | "MSFT" |
year | The fiscal year or special keywords like "ly", "ly-1", "lq", "lq-1", "lt", "lt-1" | Yes | "2022" or "lq" |
quarter | The fiscal quarter number (1 to 4), if applicable. Defaults to "1" if omitted. | No | 2 |
TTM | Set to "TTM" for trailing twelve months, otherwise leave blank. |
No | "TTM" |
?? Note: If an invalid symbol is provided, or if an internal error occurs, the function returns
"NA"
.
Return Value:
The function returns a numeric value representing the total common shares outstanding for the specified period. If the data is unavailable or invalid, it returns "NA"
.
Examples and Usage
Below are practical ways to use hf_Total_Common_Shares_Outstanding
in Excel with MarketXLS:
-
By referencing a symbol directly:
=hf_Total_Common_Shares_Outstanding("MSFT", 2022)
Fetches MSFT’s total common shares outstanding for the year 2022.
-
By specifying year and quarter:
=hf_Total_Common_Shares_Outstanding("MSFT", 2022, 2) =hf_Total_Common_Shares_Outstanding("MSFT", 2022, 3, "TTM")
- The first returns data for Q2 of 2022.
- The second returns trailing twelve months (TTM) data from Q3 2022.
-
Using special keywords:
=hf_Total_Common_Shares_Outstanding("MSFT", "lq") =hf_Total_Common_Shares_Outstanding("MSFT", "lq-1") =hf_Total_Common_Shares_Outstanding("MSFT", "ly") =hf_Total_Common_Shares_Outstanding("MSFT", "ly-1") =hf_Total_Common_Shares_Outstanding("MSFT", "lt") =hf_Total_Common_Shares_Outstanding("MSFT", "lt-1")
- "lq" fetches last quarter.
- "ly" fetches last year.
- "lt" fetches last 12 months.
- Suffixes like "-1" go further back historically.
? Pro Tip: You can supply dates in multiple ways if needed, for example:
- Using a cell reference: =hf_Total_Common_Shares_Outstanding(A1)
- Using direct dates: =hf_Total_Common_Shares_Outstanding("2024-03-15")
- Using Excel date functions: =hf_Total_Common_Shares_Outstanding(TEXT(A1,"yyyy-mm-dd"))
Common Questions
1. What if my symbol returns "NA"?
If you get an "NA" result, verify:
- The symbol is valid (e.g., "MSFT" or "^SPX").
- You have a valid MarketXLS subscription.
- The parameters (year, quarter, TTM) are correctly provided.
2. Can I use this function for non-stock assets?
Yes, you can use it for indices, options, and cryptocurrencies, as long as MarketXLS supports them.
3. Does it affect performance to use TTM vs. a single quarter?
While the function computes quickly in most cases, requesting TTM data may involve aggregating multiple historical points. However, MarketXLS handles these calls efficiently.
4. How do I compare share counts across different years?
Use the function multiple times in separate cells for each year/quarter, then compare them in Excel using standard formulas or charts.
?? Note: Data availability may vary depending on the company’s reporting frequency and historical data coverage by MarketXLS.