Common Par (Historical) Formula in Excel
Common Par (Historical) is a powerful Excel formula provided by MarketXLS that allows you to retrieve the per-share amount (par value) displayed on stock certificates or in a company’s articles of incorporation for a specific historical period. This formula helps streamline fundamental analysis by bringing critical data directly into your Excel worksheets.
Understanding Common Par (Historical)
Use this formula when you need:
- The official “par value” for a company's common share as recorded in historical financial statements
- To compare par values across different companies or multiple time periods
- A flexible approach to retrieving either annual, quarterly, or trailing twelve months (TTM) values
Key benefits:
- Automates data retrieval directly in Excel without manual lookup
- Integrates with MarketXLS to ensure accurate and up-to-date company information
- Helps in fundamental and historical analysis by quickly extracting specific per-share details
When to use:
- Historical trend analysis for a firm’s par value
- Building comparisons or longitudinal studies of company fundamentals
- Verifying data for compliance or corporate reporting purposes
Syntax and Parameters
Below is the syntax for the Common Par (Historical)
formula in Excel:
=hf_Common_par(Symbol, year, [quarter], [TTM])
Parameter | Description | Required | Example |
---|---|---|---|
Symbol | The ticker symbol or identifier of the security. | Yes | "MSFT", "^SPX", "@MSFT 110122C00020000", "BTCUSD:DEFAULT" |
year | The year for which to retrieve the data. Supports special strings like "ly", "ly-1", "lq", "lq-1", "lt", "lt-1". | Yes | 2022, "ly", or "ly-1" |
quarter | The quarter for which to retrieve the data (1 to 4). If omitted, defaults to "1" or a system-defined default in some cases. | No | 2 |
TTM | Set this to "TTM" for trailing twelve months calculation. Can also be set to values like "TTM-1" for the previous TTM. | No | "TTM" |
Return Value:
• Returns a numeric value representing the par value if data is available.
• Returns "NA" if the symbol is invalid, data is unavailable, or your license does not support the function.
?? Note: The function checks your MarketXLS license validity. If the license is invalid or if the symbol is not recognized, it will return "NA."
? Pro Tip: You can reference cells or use Excel date functions for parameters. For instance, you can place "MSFT" in A1 and 2022 in B1, then use:
=hf_Common_par(A1, B1)
Examples and Usage
Below are a few practical examples to illustrate various use cases:
-
Retrieve the value for a specific year:
=hf_Common_par("MSFT", 2022)
This returns Microsoft’s common par value for the year 2022.
-
Retrieve for a specific year and quarter:
=hf_Common_par("MSFT", 2022, 2)
This returns Microsoft’s par value for Q2 of 2022.
-
Use trailing twelve months (TTM) data:
=hf_Common_par("MSFT", 2022, 3, "TTM")
This returns the TTM par value for the end of Q3, 2022.
-
Leverage special strings for year:
=hf_Common_par("MSFT", "lq") =hf_Common_par("MSFT", "ly") =hf_Common_par("MSFT", "lt")
• "lq" for last quarter
• "ly" for last year
• "lt" for last 12 months -
Handling year offsets:
=hf_Common_par("MSFT", "lq-1") =hf_Common_par("MSFT", "ly-1") =hf_Common_par("MSFT", "lt-1")
• "lq-1" retrieves data for one quarter before the last quarter
• "ly-1" retrieves data for one year before the last year
• "lt-1" retrieves data for the previous last 12 months -
Using cell references or Excel date manipulation:
=hf_Common_par(A1, B1) =hf_Common_par("MSFT", TEXT(C1,"yyyy"), TEXT(C2,"m"))
- If A1 has "MSFT" and B1 has 2023, returns data for Microsoft in 2023.
- Dynamically convert cells to correct year/quarter formats using
TEXT()
.
Common Questions
-
What happens if the data is not available for the specified period?
• The formula will return "NA" if no data is available or if the ticker is invalid. -
Can I use the function for any asset type (indices, options, crypto)?
• Yes. Use "^SPX" for indices, "@MSFT 110122C00020000" for options, or "BTCUSD:DEFAULT" for crypto. -
Does the function affect Excel performance?
• Generally, it is optimized for quick data retrieval. However, retrieving large sets of data or using the formula extensively in a workbook can lead to increased load times. -
Should I include a quarter parameter for annual data?
• No, annual data typically only requires a year value. The quarter parameter is optional but can refine results. -
How does trailing twelve months (TTM) work here?
• The TTM option aggregates data from the last 12 months up to the specified quarter or “lt” reference, providing a rolling view of the par value data.
For related metrics, try:
- Revenue (Historical)
- Cost Of Revenue (Historical)
- Gross Profit (Historical)
- R & D Expenses (Historical)
- Selling General and Administrative Expense (Historical)
These formulas give you deeper insights into a company’s overall fundamentals when used together.