Analytics SAQL Developer Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
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

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. 
q = 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. 
q = 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.
q = 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.
q = 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.
q = 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.
q = 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. 
q = 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. 
q = foreach q generate fiscal_year_first_day(toDate('CloseDate_sec_epoch')) as 'Fiscal Year First Day';