WEEKDAY

Returns a number representing the day of the week for a given date.

Sample usage

WEEKDAY(Date)

Syntax

The following syntax returns a number that represents the day of the week from a Date value.

WEEKDAY( date_expression )

The following syntax returns a number that represents the day of the week from a compatibility mode Date value.

WEEKDAY( X [, format_string ])

Parameters

  • date_expression - a Date & Time field or expression.
  • X - a field or expression that evaluates to Text, Number, or compatibility mode Date.
  • format_string - format for X. Optional if X is correctly configured as a semantic date field.

Input format for compatibility mode dates

Supported date functions accept the following input formats if X is a Text field or expression, or compatibility mode Date:

  • BASIC: %Y/%m/%d-%H:%M:%S
  • DEFAULT_DASH: %Y-%m-%d [%H:%M:%S]
  • DEFAULT_SLASH: %Y/%m/%d [%H:%M:%S]
  • DEFAULT_DECIMAL: %Y%m%d [%H:%M:%S]
  • RFC_1123: for example, Sat, 24 May 2008 20:09:47 GMT
  • RFC_3339: for example, 2008-05-24T20:09:47Z
  • DECIMAL_DATE: same as DEFAULT_DECIMAL

Any valid strptime format is accepted.

Supported time functions accept the following input format if X is a Number field or expression:

  • SECONDS: seconds since Epoch
  • MILLIS: milliseconds since Epoch
  • MICROS: microseconds since Epoch
  • NANOS: nanoseconds since Epoch
  • JULIAN_DATE: days since Epoch

Examples

Example formula Input Output
WEEKDAY(Date) Jan 1, 2019 2
WEEKDAY(Date as Text, 'BASIC') 2019/01/01-09:40:45 2
WEEKDAY(Date as Number, 'SECONDS') 1561784874 6

WEEKDAY(Date as lots of Numbers, 'MILLIS')

1562004058620 1

Notes

This function works with both compatibility mode dates and upgraded Date and Date & Time data types.

Days are counted from Sunday and the value of Sunday is 0, therefore the value of Saturday is 6.