Перейти к содержимому
Последнее обновление

WEEKDAY

Описание​

Функция WEEKDAY возвращает индекс дня недели для даты: 0 для понедельника, 1 для вторника и 6 для воскресенья.

Обратите внимание на различие между WEEKDAY и DAYOFWEEK:

          +-----+-----+-----+-----+-----+-----+-----+
          | Sun | Mon | Tues| Wed | Thur| Fri | Sat |
          +-----+-----+-----+-----+-----+-----+-----+
  weekday |  6  |  0  |  1  |  2  |  3  |  4  |  5  |
          +-----+-----+-----+-----+-----+-----+-----+
dayofweek |  1  |  2  |  3  |  4  |  5  |  6  |  7  |
          +-----+-----+-----+-----+-----+-----+-----+

Поведение этой функции соответствует поведению функции weekday в MySQL.

Синтаксис​

WEEKDAY(`<date_or_time_expr>`)

Параметры​

ПараметрОписание
<date_or_time_expr>Входное значение даты и времени. Поддерживаются типы DATE/DATETIME/TIMESTAMP_NS. Подробнее о форматах см. в разделах преобразование даты и времени и преобразование даты

Возвращаемое значение​

Возвращает индекс, соответствующий дню недели указанной даты. Тип возвращаемого значения: INT.

  • Если входное значение равно NULL, возвращает NULL

Примеры​

-- 2023-10-09 is Monday, returns 0
SELECT WEEKDAY('2023-10-09'); 
+-------------------------+
| WEEKDAY('2023-10-09')   |
+-------------------------+
| 0                       |
+-------------------------+

-- 2023-10-15 is Sunday, returns 6
SELECT WEEKDAY('2023-10-15 18:30:00'); 
+----------------------------------+
| WEEKDAY('2023-10-15 18:30:00')   |
+----------------------------------+
| 6                                |
+----------------------------------+

-- Input is NULL, returns NULL
SELECT WEEKDAY(NULL);
+---------------+
| WEEKDAY(NULL) |
+---------------+
|          NULL |
+---------------+
Report issue