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.

To enable Time Zone for your org, follow the directions in Enable Custom Time Zones.

For the allowed formats, see Date Formats.

  • year (DateTime | DateOnly)
  • quarter (DateTime | DateOnly)
  • month (DateTime | DateOnly)
  • week (DateTime | DateOnly)
  • day (DateTime | DateOnly)
  • hour (DateTime)
  • minute (DateTime)
  • second (DateTime)
  • fiscalYear (DateTime | DateOnly)
  • fiscalQuarter (DateTime | DateOnly)
  • fiscalMonth (DateTime | DateOnly)
  • fiscalWeek (DateTime | DateOnly)
  • epochDay (DateTime | DateOnly)
  • epochSecond( DateTime | DateOnly)

Examples

Use year(), month(), and day() to project the year, month, and day for each record. CloseDate can be a DateTime or DateOnly type.
q = foreach q generate year('CloseDate') as "Year", month('CloseDate') as "Month", day('CloseDate') as "Day";

Use month() to find results that closed in December.

q = filter q by month('CloseDate') == 12;

Use month() to order opportunities by month of close date.

q = order q by month('CloseDate');

For even more granularity, add hour(), minute(), and second() to project the time for each record. These functions can only be used with a DateTime type.

q = foreach q generate year('CloseDate') as "Year", month('CloseDate') as "Month", day('CloseDate') as "Day", 
          hour('CloseDate') as "Hour", minute('CloseDate') as "Minute", second('CloseDate') as "Second";

Use hour() to order opportunities by hour of close date.

q = order q by hour('CloseDate');