Analytics SAQL Developer Guide
Summer '26 (API version 67.0)
Spring '26 (API version 66.0)
Winter '26 (API version 65.0)
Summer '25 (API version 64.0)
Spring '25 (API version 63.0)
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Spring '17 (API version 39.0)
Winter '17 (API version 38.0)
Summer '16 (API version 37.0)
Spring '16 (API version 36.0)
Winter '16 (API version 35.0)
Use Time Zone-Enabled Dates in SAQL Projections
Access Date Functions with Time Zone Enabled
Group By Date
Order By Date
Filter By Date
Handle Null Dates
Windowing Functions
coalesce
Newer Version Available
Time Zone Date Functions
When you enable the time zone feature, you can use the fields of the DateTime and DateOnly type to
access date information in the specified time zone. For example, if a user in New York runs a SAQL
query, they see date information displayed in Eastern Standard time.
In SAQL, the DateOnly type displays the date with an empty timestamp, for example, “2014-12-31 00:00:00.” The inclusion of the timestamp is a limitation of the beta release.
Note
-
Use Time Zone-Enabled Dates in SAQL Projections
You can project an exact date such as 2017-3-31 23:59:59 or part of a date such as year, month, or day. -
Access Date Functions with Time Zone Enabled
Use these functions to get the day, week, year, and other parts of DateTime or DateOnly fields. The return values are numbers. -
Group By Date
You can group the result of your SAQL query by DateTime and DateOnly fields. -
Order By Date
You can order the result of your SAQL queries by DateTime or DateOnly. -
Filter By Date
You can filter results by DateTime and DateOnly fields. Filters can include exact dates, specific date ranges, or relative date ranges. -
Calculate the Time Between Two Dates
Use date_diff() and daysBetween() to calculate the time between two dates. -
Convert Dates to and from Strings
You can convert dates to strings. -
Handle Null Dates
Use is not null to filter out null dates. -
Determine the Day in the Week, Month, Quarter, or Year
These functions return the day of the week, month, quarter, or year, the date of the last day of the week, month, quarter, or year, and the number of days in the quarter or year.