Analytics SAQL Developer Guide

Overview
Quick Start
Examples
SAQL Reference
SAQL Basic Elements
SAQL Operators
SAQL Statements
SAQL Functions
Aggregate Functions
Date Functions
daysBetween()
date_diff()
now()
date()
toDate()
date_to_epoch()
date_to_string()
toString()
Time-Based Filtering
Day in the Week, Month, Quarter, or Year
First Day in the Week, Month, Quarter, or Year
Last Day in the Week, Month, Quarter, or Year
Number of Days in the Month, Quarter, or Year
Date Formats
Time Zone Date Functions
Work with Custom Fiscal Year Data
String Functions
Math Functions
Windowing Functions
coalesce
Query Performance
PDF

Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Last Day in the Week, Month, Quarter, or Year

Returns the date of the last day in the specified week, month, quarter, or year.

Usage

Use these functions in a foreach() statement. You cannot use them in group by, order by, or filter statements.

Use the functions whose names begin with week, month, quarter, and year with standard calendar year dates. Use the functions whose names begin with fiscal with fiscal year dates.

You can't use fiscal date functions in recipes and dataflow transformations.

Note

week_last_day(date)

Returns the date of the last day of the week for the specified date.

This function always counts the firstDayOfWeek as 0 (Sunday). It overrides the firstDayOfWeek parameter for sfdcDigestTransformation and CSV uploads.

Note

1q = foreach q generate week_last_day(toDate('CloseDate_sec_epoch')) as 'Week Last Day';

fiscal_week_last_day(date)

Returns the fiscal date of the last day of the week for the specified date.

This function respects the firstDayOfWeek parameter for sfdcDigestTransformation and CSV uploads. The default value is 0 (Sunday).

Note

1q = foreach q generate fiscal_week_last_day(toDate('CloseDate_sec_epoch')) as 'Fiscal Week Last Day';

month_last_day(date)

Returns the date of the last day of the month for the specified date.
1q = foreach q generate month_last_day(toDate('CloseDate_sec_epoch')) as 'Month Last Day';

fiscal_month_last_day(date)

Returns the fiscal date of the last day of the month for the specified date.
1q = foreach q generate fiscal_month_last_day(toDate('CloseDate_sec_epoch')) as 'Fiscal Month Last Day';

quarter_last_day(date)

Returns the date of the last day of the quarter for the specified date.
1q = foreach q generate quarter_last_day(toDate('CloseDate_sec_epoch')) as 'Quarter Last Day';

fiscal_quarter_last_day(date)

Returns the fiscal date of the last day of the quarter for the specified date.
1q = foreach q generate fiscal_quarter_last_day(toDate('CloseDate_sec_epoch')) as 'Fiscal Quarter Last Day';

year_last_day(date)

Returns the date of the last day of the year for the specified date. 
1q = foreach q generate year_last_day(toDate('CloseDate_sec_epoch')) as 'Year Last Day';

This function always returns 31st December. You can use it to find the number of days to the year end.

Note

fiscal_year_last_day(date)

Returns the fiscal date of the last day of the year for the specified date. 
1q = foreach q generate fiscal_year_last_day(toDate('CloseDate_sec_epoch')) as 'Fiscal Year Last Day';