Home MarketXLS
Dashboard MarketXLS
Screener MarketXLS
Options Profit Calculator MarketXLS
Stock Ranks MarketXLS
Spreadsheet Builder MarketXLS
Documentation MarketXLS
Logout MarketXLS

Long Term Debt (Historical) Formula in Excel

Use the Long Term Debt (Historical) formula in Excel (with MarketXLS) to retrieve a company's long-term debts—obligations due more than one year in the future. This function helps investors, analysts, and finance professionals assess a company's leverage and financial health.

Understanding Long Term Debt (Historical)

Long-term debt represents a company’s outstanding liabilities that are due beyond the next 12 months.

  • Helps evaluate a firm’s financial risk and capital structure.
  • Useful in credit analysis, ratio analysis (e.g., debt-to-equity), and trend analysis.
  • Provides quick insights into how heavily a company relies on debt financing.

? Pro Tip: Use this formula alongside other historical fundamental formulas (e.g., revenue, gross profit) to build a comprehensive financial analysis directly in Excel.

Syntax and Parameters

Below is the general syntax for the Long Term Debt (Historical) formula:

=hf_Long_Term_Debt(symbol, year, [quarter], [TTM])
Parameter Description Required Example
symbol Stock or asset identifier. Supports equities (e.g., "MSFT"), indices (e.g., "^SPX"), options (e.g., "@MSFT 110122C00020000"), and crypto (e.g., "BTCUSD:DEFAULT"). Yes "MSFT"
year The year you want to retrieve data for. Also accepts special notations like "lq" (last quarter), "ly" (last year), and "lt" (last 12 months). Yes "2022", "lq", "ly-1"
quarter The calendar quarter you want (1, 2, 3, or 4). Defaults to "1". For TTM, this can refine the trailing period. No "2"
TTM Set to "TTM" to fetch trailing twelve months data. Otherwise, leave blank. No "TTM"

Return Value:
• Returns a numeric value reflecting the total long-term debt for the specified period.
• If data is unavailable or the symbol is invalid, the function returns "NA".

?? Note: Make sure your MarketXLS license is valid; otherwise, the function returns "NA."

Examples and Usage

  1. Retrieving the most recent annual long-term debt:
    =hf_Long_Term_Debt("MSFT", "2022")
  2. Including a specific calendar quarter:
    =hf_Long_Term_Debt("MSFT", "2022", 2)
  3. Fetching trailing twelve months (TTM) data for Q3 of 2022:
    =hf_Long_Term_Debt("MSFT", "2022", 3, "TTM")
  4. Using special keywords for periods:
    • Last Quarter:
      =hf_Long_Term_Debt("MSFT", "lq")
    • Last Quarter minus one:
      =hf_Long_Term_Debt("MSFT", "lq-1")
    • Last Year:
      =hf_Long_Term_Debt("MSFT", "ly")
    • Previous Last 12 Months:
      =hf_Long_Term_Debt("MSFT", "lt-1")

Date Input Variations

  • Using a cell reference (A1 containing "2024-03-15"):
    =hf_Long_Term_Debt("MSFT", TEXT(A1,"yyyy-mm-dd"))
  • Direct date input:
    =hf_Long_Term_Debt("MSFT", "2024-03-15")
  • Excel date functions:
    =hf_Long_Term_Debt("MSFT", TEXT(TODAY(),"yyyy-mm-dd"))

Common Questions

  1. What happens if the symbol is invalid?

    • The function returns "NA" when the symbol or data is not recognized.
  2. Can I apply this formula to multiple stocks at once?

    • Yes. However, each formula call retrieves data from an external source, so using many calls at once may slow performance. Consider caching or using fewer formulas if needed.
  3. Is the data updated in real-time?

    • This formula retrieves historical data. Updates depend on the frequency and availability of MarketXLS’s data sources.
  4. Why do I get "NA" occasionally for certain dates?

    • The specified date or quarter may not have reported data or might be outside MarketXLS’s data coverage.

? Pro Tip: Combine Long Term Debt (Historical) with other historical fundamental metrics like Revenue (Historical) and Gross Profit (Historical) to build robust financial models in Excel.