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.

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

Returns the date of the first 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_first_day(date)

Returns the date of the first day of the week for the specified date. 
1q = foreach q generate week_first_day(toDate('CloseDate_sec_epoch')) as 'Week First Day';

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

Note

fiscal_week_first_day(date)

Returns the fiscal date of the first day of the week for the specified date. 
1q = foreach q generate fiscal_week_first_day(toDate('CloseDate_sec_epoch')) as 'Fiscal Week First Day';

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

Note

month_first_day(date)

Returns the date of the first day of the month for the specified date.
1q = foreach q generate month_first_day(toDate('CloseDate_sec_epoch')) as 'Month First Day';

fiscal_month_first_day(date)

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

quarter_first_day(date)

Returns the date of the first day of the quarter for the specified date.
1q = foreach q generate quarter_first_day(toDate('CloseDate_sec_epoch')) as 'Quarter First Day';

fiscal_quarter_first_day(date)

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

year_first_day(date)

Returns the date of the first day of the year for the specified date. 
1q = foreach q generate year_first_day(toDate('CloseDate_sec_epoch')) as 'Year First day';

This function always returns 1st January.

Note

fiscal_year_first_day(date)

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