Earnings Calendar

Use the SF_CALENDAR() function with type="earnings" to retrieve historic and upcoming earnings release data. The function returns rows for each earnings event within the requested date range and the metrics you select.

=SF_CALENDAR(searchTerms, "earnings", startDate, endDate, metrics, options)

The maximum date range for a single call is 90 days. If the range between startDate and endDate is larger, it is truncated to 90 days. For longer ranges, make multiple calls and combine them with HSTACK or VSTACK.

Available metrics

Chain metrics together with & or use "all" to return every column.

Date ("date")
Symbol ("symbol")
EPS ("eps")
EPS Estimate ("epsEstimated")
Release Timing ("time")
Revenue ("revenue")
Revenue Estimate ("revenueEstimated")
Fiscal Date Ending ("fiscalDateEnding")
Updated ("updatedFromDate")

Examples

Filter by exchange and select specific metrics

Return earnings for the NSE over the next 30 days with date, symbol, release timing, and fiscal date ending.

=SF_CALENDAR(".NS", "earnings", TODAY(), TODAY()+30, "date&symbol&time&fiscalDateEnding")

Filter by exact symbol

Use the $ exact-match operator to return earnings for AAPL only (not AAPL.PA or AAPL.DE).

=SF_CALENDAR("$AAPL", "earnings", TODAY(), TODAY()+30, "all")

For full syntax details, including searchTerms filtering and the options parameter, see the Financial Calendars overview.

Was this helpful?